PPTenantSettings

Parameters

Parameter Attribute DataType Description Allowed Values
IsSingleInstance Key String Should be set to yes Yes
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
    }
  }
}