New command: pp tenant settings set

[milanholemans]

Usage

m365 pp tenant settings set [options]

Description

Sets the global Power Platform configuration of the tenant

Options

Option	Description
--walkMeOptOut [walkMeOptOut]	Ability to opt out of guided experiences using WalkMe in Power Platform. Valid values: true, false.
--disableNPSCommentsReachout [disableNPSCommentsReachout]	Ability to disable re-surveying users who left prior feedback via NPS prompts in Power Platform. Valid values: true, false.
--disableNewsletterSendout [disableNewsletterSendout]	Ability to disable the newsletter sendout feature. Valid values: true, false.
--disableEnvironmentCreationByNonAdminUsers [disableEnvironmentCreationByNonAdminUsers]	Restrict all environments to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: true, false.
--disablePortalsCreationByNonAdminUsers [disablePortalsCreationByNonAdminUsers]	Restrict all portals to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: true, false.
--disableSurveyFeedback [disableSurveyFeedback]	Ability to disable all NPS survey feedback prompts in Power Platform. Valid values: true, false.
--disableTrialEnvironmentCreationByNonAdminUsers [disableTrialEnvironmentCreationByNonAdminUsers]	Restrict all trial environments to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: true, false.
--disableCapacityAllocationByEnvironmentAdmins [disableCapacityAllocationByEnvironmentAdmins]	Ability to disable capacity allocation by environment administrators. Valid values: true, false.
--disableSupportTicketsVisibleByAllUsers [disableSupportTicketsVisibleByAllUsers]	Ability to disable support ticket creation by non-admin users in the tenant. Valid values: true, false.
--disableDocsSearch [disableDocsSearch]	When this setting is true, users in the environment will see a message that Microsoft Learn and Documentation search categories have been turned off by the administrator in the search results page. Valid values: true, false.
--disableCommunitySearch [disableCommunitySearch]	When this setting is true, users in the environment will see a message that Community and Blog search categories have been turned off by the administrator in the search results page. Valid values: true, false.
--disableBingVideoSearch [disableBingVideoSearch]	When this setting is true, users in the environment will see a message that Video search categories have been turned off by the administrator in the search results page. Valid values: true, false.
--shareWithColleaguesUserLimit [shareWithColleaguesUserLimit]	Maximum value setting for the number of users in a security group used to share an app built using Power Apps on Microsoft Teams. Specify any number as a value.
--disableShareWithEveryone [disableShareWithEveryone]	Ability to disable the Share With Everyone capability in all Power Apps. Valid values: true, false.
--enableGuestsToMake [enableGuestsToMake]	Ability to allow guest users in your tenant to create Power Apps. Valid values: true, false.
--disableMembersIndicator [disableMembersIndicator]	Ability to disable the display of a members indicator. Valid values: true, false.
--disableMakerMatch [disableMakerMatch]	Ability to disable the Maker Match feature, which helps organizations find internal resources with the necessary skills to develop custom apps and solutions using Power Platform. Valid values: true, false.
--disablePreferredDataLocationForTeamsEnvironment [disablePreferredDataLocationForTeamsEnvironment]	Ability to disable the selection of a preferred data location for Teams environment. Valid values: true, false.
--disableAdminDigest [disableAdminDigest]	When true, the entire organization is unsubscribed from the weekly digest. Valid values: true, false.
--disableDeveloperEnvironmentCreationByNonAdminUsers [disableDeveloperEnvironmentCreationByNonAdminUsers]	Restrict all developer environments to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: true, false.
--disableBillingPolicyCreationByNonAdminUsers [disableBillingPolicyCreationByNonAdminUsers]	Restrict billing policies to be created by Global Admins, Power Platform Admins, or Dynamics365 Service Admins. Valid values: true, false.
--storageCapacityConsumptionWarningThreshold [storageCapacityConsumptionWarningThreshold]	Ability to set a threshold for storage capacity consumption warnings. Specify any number as a value.
--disableChampionsInvitationReachout [disableChampionsInvitationReachout]	Ability to disable all invitations to become a Power Platform champion. Valid values: true, false.
--disableSkillsMatchInvitationReachout [disableSkillsMatchInvitationReachout]	Ability to disable all skills match invitations to become part of the makers community. Valid values: true, false.
--disableCopilot [disableCopilot]	Ability to turn off or disable the Copilot feature. Valid values: true, false.
--enableOpenAiBotPublishing [enableOpenAiBotPublishing]	Ability to enable or disable the publishing of OpenAI bots within the organization's environment. Valid values: true, false.
--enableModelDataSharing [enableModelDataSharing]	Ability to enable or disable the sharing of model data within the organization's environment. Valid values: true, false.

Examples

Disable environment creation for non-admin users

m365 pp tenant settings set --disableEnvironmentCreationByNonAdminUsers true --disableTrialEnvironmentCreationByNonAdminUsers true --disableDeveloperEnvironmentCreationByNonAdminUsers true

Enable Power App creation for guest users

m365 pp tenant settings set --enableGuestsToMake true

Disable guided experience, survey feedback and newsletter

m365 pp tenant settings set --walkMeOptOut true --disableNewsletterSendout true --disableSurveyFeedback true

Additional Info

Docs

• Attention: This command is based on an API that is currently in preview and is subject to change once the API reached general availability.

API request

POST https://api.bap.microsoft.com/providers/Microsoft.BusinessAppPlatform/scopes/admin/updateTenantSettings?api-version=2020-10-01

{
    "walkMeOptOut": false,
    "disableNPSCommentsReachout": false,
    "disableNewsletterSendout": false,
    "disableEnvironmentCreationByNonAdminUsers": false,
    "disablePortalsCreationByNonAdminUsers": false,
    "disableSurveyFeedback": false,
    "disableTrialEnvironmentCreationByNonAdminUsers": false,
    "disableCapacityAllocationByEnvironmentAdmins": false,
    "disableSupportTicketsVisibleByAllUsers": false,
    "powerPlatform": {
        "search": {
            "disableDocsSearch": false,
            "disableCommunitySearch": false,
            "disableBingVideoSearch": false
        },
        "teamsIntegration": {
            "shareWithColleaguesUserLimit": 10000
        },
        "powerApps": {
            "disableShareWithEveryone": false,
            "enableGuestsToMake": false,
            "disableMembersIndicator": false
        },
        "environments": {},
        "governance": {
            "disableAdminDigest": false,
            "disableDeveloperEnvironmentCreationByNonAdminUsers": false
        },
        "licensing": {
            "disableBillingPolicyCreationByNonAdminUsers": false
        },
        "powerPages": {},
        "champions": {
            "disableChampionsInvitationReachout": false,
            "disableSkillsMatchInvitationReachout": false
        }
    }
}

[milanholemans]

@pnp/cli-for-microsoft-365-maintainers lots of options, also lots of options with long names. Is this fine, or should we try to rephrase it?

[milanholemans]

@appieschot seems like I can't find a decent description for the last 2 options, do you have any idea?

[Jwaegebaert]

Nice work speccing out this issue @milanholemans! The long names don't look the best but I don't think there is a better alternative to it. As for the last 2 options, I'm also not quite sure what they stand for.

[appieschot]

@milanholemans My best guess would be that this is the Maker Matching: https://learn.microsoft.com/en-us/power-apps/maker/common/maker-matching or https://learn.microsoft.com/en-us/power-platform-release-plan/2022wave2/power-apps/skills-match-power-apps-makers not sure what the official name is ;-)

[appieschot]

And for the long names perhaps we should consider setting it with json input as well; this JSON seems to change frequently, so that would help us in supporting things quicker (though it isn't as nice as having the parameters available ofcourse)

[milanholemans]

Tried to make a description for the last 2 options.

And for the long names perhaps we should consider setting it with json input as well; this JSON seems to change frequently, so that would help us in supporting things quicker (though it isn't as nice as having the parameters available ofcourse)

If I'm not mistaken, using a JSON as input is a line we try not to cross.

[appieschot]

@milanholemans Just my take :-) I do get that it is not as user friendly and am aware that we have deprecated our schemaXml properties we have on other locations but would still be worth the discussion afaic; if I am the only one I am happy to lay it to rest 😉

[milanholemans]

Let's ping the other @pnp/cli-for-microsoft-365-maintainers 😊

[waldekmastykarz]

While the option names are long, if they align with the API, let's use them. That will make it easier for folks to find additional information if need be, rather than depending on our made-up names and trying to match them with the underlying API.

[nicodecleyre]

Would love to implement this one!

Great specs @milanholemans, appreciate the detailed description!

[milanholemans]

Thanks @nicodecleyre
Also thank you for picking this one up!

[nicodecleyre]

Tried to give a definition to the new options. Feel free to indicate if the definitions need some changes

Option	Description
--disableMembersIndicator [disableMembersIndicator]	Ability to disable the display of a members indicator. Valid values: true, false.
--disableMakerMatch [disableMakerMatch]	Ability to disable the Maker Match feature, which helps organizations find internal resources with the necessary skills to develop custom apps and solutions using Power Platform. Valid values: true, false.
--disablePreferredDataLocationForTeamsEnvironment [disablePreferredDataLocationForTeamsEnvironment]	Ability to disable the selection of a preferred data location for Teams environment. Valid values: true, false.
--storageCapacityConsumptionWarningThreshold [storageCapacityConsumptionWarningThreshold]	Ability to set a threshold for storage capacity consumption warnings. Specify any number as a value.
--disableCopilot [disableCopilot]	Ability to turn off or disable the Copilot feature. Valid values: true, false.
--enableOpenAiBotPublishing [enableOpenAiBotPublishing]	Ability to enable or disable the publishing of OpenAI bots within the organization's environment. Valid values: true, false.
--enableModelDataSharing [enableModelDataSharing]	Ability to enable or disable the sharing of model data within the organization's environment. Valid values: true, false.

[milanholemans]

Great work @nicodecleyre!
Sometimes finding the right description for a setting can be quite challenging, but you nailed it.