PPTenantSettings

Parameters

Parameter Attribute DataType Description Allowed Values
IsSingleInstance Key String Should be set to yes Yes
DisableCopilotFeedback Write Boolean TBD
DisableMakerMatch Write Boolean TBD
DisableUnusedLicenseAssignment Write Boolean TBD
DisableCreateFromImage Write Boolean TBD
DisableConnectionSharingWithEveryone Write Boolean TBD
AllowNewOrgChannelDefault Write Boolean TBD
DisableCopilot Write Boolean TBD
DisableCopilotWithBing Write Boolean TBD
DisableAdminDigest Write Boolean TBD
DisablePreferredDataLocationForTeamsEnvironment Write Boolean TBD
DisableDeveloperEnvironmentCreationByNonAdminUsers Write Boolean TBD
EnvironmentRoutingAllMakers Write Boolean TBD
EnableDefaultEnvironmentRouting Write Boolean TBD
EnableDesktopFlowDataPolicyManagement Write String TBD
EnableCanvasAppInsights Write Boolean TBD
DisableCreateFromFigma Write Boolean TBD
DisableBillingPolicyCreationByNonAdminUsers Write Boolean TBD
StorageCapacityConsumptionWarningThreshold Write UInt32 TBD
EnableTenantCapacityReportForEnvironmentAdmins Write Boolean TBD
EnableTenantLicensingReportForEnvironmentAdmins Write Boolean TBD
DisableUseOfUnassignedAIBuilderCredits Write Boolean TBD
EnableGenerativeAIFeaturesForSiteUsers Write String TBD
EnableExternalAuthenticationProvidersInPowerPages Write String TBD
DisableChampionsInvitationReachout Write Boolean TBD
DisableSkillsMatchInvitationReachout Write Boolean TBD
EnableOpenAiBotPublishing Write Boolean TBD
DisableAiPrompts Write Boolean TBD
DisableCopilotFeedbackMetadata Write Boolean TBD
EnableModelDataSharing Write Boolean TBD
DisableDataLogging Write Boolean TBD
PowerCatalogAudienceSetting Write String TBD
EnableDeleteDisabledUserinAllEnvironments Write Boolean TBD
DisableHelpSupportCopilot Write Boolean TBD
DisableSurveyScreenshots Write Boolean TBD
WalkMeOptOut Write Boolean When set to true this will disable the Walk Me guidance.
DisableNPSCommentsReachout Write Boolean When set to true this will disable the NPS Comments Reachout.
DisableNewsletterSendout Write Boolean When set to true this will disable the monthly newsletters.
DisableEnvironmentCreationByNonAdminUsers Write Boolean When set to true this will disable production environment creation by non-admin users.
DisablePortalsCreationByNonAdminUsers Write Boolean When set to true this will disable portal creation by non-admin users.
DisableSurveyFeedback Write Boolean When set to true this will disable survey feedback that sometimes pops up on top of an app.
DisableTrialEnvironmentCreationByNonAdminUsers Write Boolean When set to true this will disable trial environment creation by non-admin users.
DisableCapacityAllocationByEnvironmentAdmins Write Boolean When set to true this will disable capacity allocation by environment admins.
DisableSupportTicketsVisibleByAllUsers Write Boolean When set to true this will disable support tickets to be visible by all users.
DisableDocsSearch Write Boolean When set to true this will disable docs search in the Office 365 Suite navigation bar.
DisableCommunitySearch Write Boolean When set to true this will disable community search in the Office 365 Suite navigation bar.
DisableBingVideoSearch Write Boolean When set to true this will disable Bing video search in the Office 365 Suite navigation bar.
DisableShareWithEveryone Write Boolean When set to true this will disable the ability to share apps with the whole tenant.
EnableGuestsToMake Write Boolean When set to true this will enable the ability for guests in your tenant to create Power Platform resources.
ShareWithColleaguesUserLimit Write UInt32 The amount of people an app can be shared with in Dataverse for Teams (maximum is 10,000).
Credential Write PSCredential Credentials of the Power Platform Admin
ApplicationId Write String Id of the Azure Active Directory application to authenticate with.
TenantId Write String Id of the Azure Active Directory tenant used for authentication.
ApplicationSecret Write PSCredential Secret of the Azure Active Directory tenant used for authentication.
CertificateThumbprint Write String Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication.

Description

This resource configures a Power Platform Tenant.

Permissions

Microsoft Graph

To authenticate with the Microsoft Graph API, this resource required the following permissions:

Delegated permissions

  • Read

    • None
  • Update

    • None

Application permissions

  • Read

    • None
  • Update

    • None

Examples

Example 1

This example sets Power Platform tenant settings.

Configuration Example
{
  param(
    [Parameter(Mandatory = $true)]
    [PSCredential]
    $Credscredential
  )
  Import-DscResource -ModuleName Microsoft365DSC

  node localhost
  {
    PPTenantSettings 'PowerPlatformTenantSettings'
    {
      IsSingleInstance                               = 'Yes'
      WalkMeOptOut                                   = $false
      DisableNPSCommentsReachout                     = $false
      DisableNewsletterSendout                       = $false
      DisableEnvironmentCreationByNonAdminUsers      = $true
      DisablePortalsCreationByNonAdminUsers          = $false
      DisableSurveyFeedback                          = $false
      DisableTrialEnvironmentCreationByNonAdminUsers = $false
      DisableCapacityAllocationByEnvironmentAdmins   = $true
      DisableSupportTicketsVisibleByAllUsers         = $false
      DisableDocsSearch                              = $false
      DisableCommunitySearch                         = $false
      DisableBingVideoSearch                         = $false
      DisableShareWithEveryone                       = $false
      EnableGuestsToMake                             = $false
      ShareWithColleaguesUserLimit                   = 10000
      Credential                                     = $Credscredential
    }
  }
}