Set-EntraDirectoryRoleDefinition

Set-EntraDirectoryRoleDefinition

    [-TemplateId <String>]
    [-DisplayName <String>]
    [-RolePermissions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RolePermission]>]
    -UnifiedRoleDefinitionId <String>
    [-Description <String>]
    [-Version <String>]
    [-IsEnabled <Boolean>]
    [-ResourceScopes <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

Aktualisiert ein durch die ID identifiziertes Microsoft Entra roleDefinition-Objekt. Integrierte Rollen können nicht aktualisiert werden. Dieses Feature erfordert eine Microsoft Entra ID P1- oder P2-Lizenz.

In delegierten Szenarien muss der angemeldete Benutzer entweder über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Die für diesen Vorgang erforderlichen Mindestrollen sind:

• Administrator für privilegierte Rollen

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -DisplayName 'UpdatedDisplayName'

In diesem Beispiel wird die angegebene Rollendefinition in Microsoft Entra ID aktualisiert.

• -UnifiedRoleDefinitionId der Parameter gibt die roleDefinition-Objekt-ID an.
• -DisplayName der Parameter gibt den Anzeigenamen für die Rollendefinition an.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -Description 'MYROLEUPDATE1S'

In diesem Beispiel wird die Beschreibung der angegebenen Rollendefinition in Microsoft Entra ID aktualisiert.

• -UnifiedRoleDefinitionId der Parameter gibt die roleDefinition-Objekt-ID an.
• -Description der Parameter gibt die Beschreibung für die Rollendefinition an.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
Set-EntraDirectoryRoleDefinition -UnifiedRoleDefinitionId $roleDefinition.Id -IsEnabled $true

In diesem Beispiel wird die IsEnabled der angegebenen Rollendefinition in Microsoft Entra ID aktualisiert.

• -UnifiedRoleDefinitionId der Parameter gibt die roleDefinition-Objekt-ID an.
• -IsEnabled Der Parameter gibt an, ob die Rollendefinition aktiviert ist.

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$roleDefinition = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq '<Role-Definition-Name>'"
$rolePermissions = New-object Microsoft.Open.MSGraph.Model.RolePermission
$rolePermissions.AllowedResourceActions = @("microsoft.directory/applications/standard/read")
$params = @{
    UnifiedRoleDefinitionId = $roleDefinition.Id
    Description             = 'Update'
    DisplayName             = 'Update'
    ResourceScopes          = '/'
    IsEnabled               = $false
    RolePermissions         = $rolePermissions
    TemplateId              = 'f2ef992c-3afb-46b9-b7cf-a126ee74c451'
    Version                 = 2
}
Set-EntraDirectoryRoleDefinition @params

In diesem Beispiel werden die RolePermissions-, TemplateId-, TemplateId-, ResourceScopes der angegebenen Rollendefinition in Microsoft Entra ID aktualisiert.

• -UnifiedRoleDefinitionId der Parameter gibt die roleDefinition-Objekt-ID an.
• -RolePermissions der Parameter gibt die Berechtigungen für die Rollendefinition an.
• -IsEnabled Der Parameter gibt an, ob die Rollendefinition aktiviert ist.
• -DisplayName der Parameter gibt den Anzeigenamen für die Rollendefinition an.
• -Description der Parameter gibt die Beschreibung für die Rollendefinition an.
• -ResourceScopes der Parameter gibt die Ressourcenbereiche für die Rollendefinition an.
• -TemplateId der Parameter gibt die Vorlagen-ID für die Rollendefinition an.
• -Version der Parameter gibt die Version für die Rollendefinition an.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Set-EntraRoleDefinition ist ein Alias für Set-EntraDirectoryRoleDefintion.