Edit

Share via

Enable Managed Environments

Admins enable, disable, and edit Managed Environments in the Power Platform admin center. Admins can also use PowerShell to disable Managed Environments. This article explains the permissions you need to manage environments and the steps to get started in the Microsoft Power Platform admin center or with PowerShell.

Permissions

To enable or edit Managed Environments, you need the Power Platform Administrator or Dynamics 365 Administrator role in Microsoft Entra ID. You can learn more about these roles in Use service admin roles to manage your tenant.

  • Any user with permission to view environment details can see the Managed Environments property for an environment.
  • Users with the Delegated Admin role or the Environment Admin security role can't change the Managed Environments property in an environment.

Important

  • The Managed Environments property must be the same in the source and destination before you can start to copy and restore environment lifecycle operations.
  • Dataverse is required to use Managed Environments in an environment type.

Enable or edit Managed Environments in the admin center

  1. Sign in to the Power Platform admin center.

  2. In the navigation pane, select Manage, and then in the Manage pane, select Environments.

  3. Select the ellipsis next to an environment, and then in the menu, select Enable Managed Environments. If the environment is already managed, select Edit Managed Environments.

  4. Configure the settings, and then select Enable or Save.

Enable Managed Environments using PowerShell

Admins can also use PowerShell to enable Managed Environments. The following PowerShell script enables it for a single environment.

$GovernanceConfiguration = [pscustomobject] @{ 
    protectionLevel = "Standard" 
    settings = [pscustomobject]@{ 
        extendedSettings = @{} 
    }
} 

Set-AdminPowerAppEnvironmentGovernanceConfiguration -EnvironmentName <EnvironmentID> -UpdatedGovernanceConfiguration $GovernanceConfiguration

Copy Managed Environment settings using PowerShell

Admins can use PowerShell to copy settings from one Managed Environment to another environment. If the target environment isn't a Managed Environment, copying settings also enables it as a Managed Environment.

#Get settings from the source Managed Environment
$sourceEnvironment = Get-AdminPowerAppEnvironment -EnvironmentName <SourceEnvironmentId>

# Copy the settings from the source Managed Environment above to the target environment
Set-AdminPowerAppEnvironmentGovernanceConfiguration -EnvironmentName <TargetEnvironmentId> -UpdatedGovernanceConfiguration $sourceEnvironment.Internal.properties.governanceConfiguration

Disable Managed Environments using PowerShell

Admins can use PowerShell to remove the Managed Environments property from an environment. Before you disable Managed Environments, make sure none of the Managed Environments capabilities are in use.

Here's an example PowerShell script that calls the API to set the Managed Environments property:

$UpdatedGovernanceConfiguration = [pscustomobject]@{
    protectionLevel = "Basic"
}
Set-AdminPowerAppEnvironmentGovernanceConfiguration -EnvironmentName <EnvironmentID> -UpdatedGovernanceConfiguration $UpdatedGovernanceConfiguration

Related content