Set-EntraAuthorizationPolicy
Updates an authorization policy.
Syntax
Set-EntraAuthorizationPolicy
[-BlockMsolPowerShell <Boolean>]
[-AllowedToSignUpEmailBasedSubscriptions <Boolean>]
[-AllowEmailVerifiedUsersToJoinOrganization <Boolean>]
[-DisplayName <String>]
[-Description <String>]
[-DefaultUserRolePermissions <DefaultUserRolePermissions>]
[-AllowedToUseSSPR <Boolean>]
[<CommonParameters>] Description
The Set-EntraAuthorizationPolicy cmdlet updates a Microsoft Entra ID authorization policy.
For delegated scenarios, the user needs to have the Privileged Role Administrator Microsoft Entra role.
Examples
Example 1: Update an authorization policy
Connect-Entra -Scopes 'Policy.ReadWrite.Authorization'
$params = @{
DisplayName = 'Updated displayName'
Description = 'Updated Description'
BlockMsolPowerShell = $true
AllowedToUseSSPR = $false
AllowEmailVerifiedUsersToJoinOrganization = $true
AllowedToSignUpEmailBasedSubscriptions = $true
}
Set-EntraAuthorizationPolicy @paramsThis example demonstrates how to update a Microsoft Entra ID authorization policy.
Example 2: Update DefaultUserRolePermissions of authorization policy
Connect-Entra -Scopes 'Policy.ReadWrite.Authorization'
$DefaultUserRolePermissions = New-Object -TypeName Microsoft.Open.MSGraph.Model.DefaultUserRolePermissions
$DefaultUserRolePermissions.AllowedToCreateApps = $false
$DefaultUserRolePermissions.AllowedToCreateSecurityGroups = $false
$DefaultUserRolePermissions.AllowedToReadOtherUsers = $false
Set-EntraAuthorizationPolicy -DefaultUserRolePermissions $DefaultUserRolePermissionsThis example demonstrates how to update a DefaultUserRolePermissions of authorization policy in Microsoft Entra ID.
Parameters
-AllowedToSignUpEmailBasedSubscriptions
Specifies whether users can sign up for email based subscriptions. The initial default value is true.
| Type: | System.Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowedToUseSSPR
Specifies whether the Self-Serve Password Reset feature can be used by users on the tenant. The initial default value is true.
| Type: | System.Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowEmailVerifiedUsersToJoinOrganization
Specifies whether a user can join the tenant by email validation. The initial default value is true.
| Type: | System.Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-allowInvitesFrom
Indicates who can invite external users to the organization. Possible values are: none, adminsAndGuestInviters, adminsGuestInvitersAndAllMembers, everyone. Everyone is the default setting for all cloud environments except US Government.
| Type: | allowInvitesFrom |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-allowUserConsentForRiskyApps
Indicates whether user consent for risky apps is allowed. Default value is false. We recommend that you keep the value set to false.
| Type: | System.Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlockMsolPowerShell
Specifies whether the user-based access to the legacy service endpoint used by Microsoft Online PowerShell is blocked or not.
| Type: | System.Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultUserRolePermissions
Contains various customizable default user role permissions.
| Type: | DefaultUserRolePermissions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Specifies the description of the authorization policy.
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Specifies the display name of the authorization policy.
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.Open.MSGraph.Model.DefaultUserRolePermissions