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>]

Met à jour un objet roleDefinition Microsoft Entra identifié par l’ID. Vous ne pouvez pas mettre à jour les rôles intégrés. Cette fonctionnalité nécessite une licence Microsoft Entra ID P1 ou P2.

Dans les scénarios délégués, l’utilisateur connecté doit avoir un rôle de Microsoft Entra pris en charge ou un rôle personnalisé avec les autorisations nécessaires. Les rôles minimaux requis pour cette opération sont les suivants :

• Administrateur de rôle privilégié

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

Cet exemple met à jour la définition de rôle spécifiée dans Microsoft Entra ID.

• -UnifiedRoleDefinitionId spécifie l’ID d’objet roleDefinition.
• -DisplayName spécifie le nom complet de la définition de rôle.

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

Cet exemple met à jour la description de la définition de rôle spécifiée dans Microsoft Entra ID.

• -UnifiedRoleDefinitionId spécifie l’ID d’objet roleDefinition.
• -Description spécifie la description de la définition de rôle.

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

Cet exemple met à jour l’IsEnabled de la définition de rôle spécifiée dans Microsoft Entra ID.

• -UnifiedRoleDefinitionId spécifie l’ID d’objet roleDefinition.
• -IsEnabled spécifie si la définition de rôle est activée.

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

Cet exemple met à jour les RolePermissions, TemplateId, TemplateId, ResourceScopes de la définition de rôle spécifiée dans Microsoft Entra ID.

• -UnifiedRoleDefinitionId spécifie l’ID d’objet roleDefinition.
• -RolePermissions spécifie les autorisations pour la définition de rôle.
• -IsEnabled spécifie si la définition de rôle est activée.
• -DisplayName spécifie le nom complet de la définition de rôle.
• -Description spécifie la description de la définition de rôle.
• -ResourceScopes spécifie les étendues de ressource pour la définition de rôle.
• -TemplateId spécifie l’ID de modèle pour la définition de rôle.
• -Version spécifie la version de la définition de rôle.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Set-EntraRoleDefinition est un alias pour Set-EntraDirectoryRoleDefintion.