Enable-EntraDirectoryRole

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Active un rôle d’annuaire existant dans Microsoft Entra ID.

Syntaxe

Default (Par défaut) 

Enable-EntraDirectoryRole

    [-RoleTemplateId <String>]
    [<CommonParameters>]

Description

L’applet Enable-EntraDirectoryRole de commande active un rôle d’annuaire existant dans Microsoft Entra ID.

Les administrateurs d’entreprise et les rôles d’annuaire d’utilisateurs par défaut (utilisateur, utilisateur invité et utilisateur invité restreint) sont activés par défaut. Pour accéder aux autres rôles d’annuaire et les affecter, vous devez d’abord les activer à l’aide de leur ID de modèle de rôle d’annuaire correspondant.

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é

Exemples

Exemple 1 : Activer un rôle d’annuaire

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$guestRole = Get-EntraDirectoryRoleTemplate | Where-Object {$_.DisplayName -eq 'Guest Inviter'}
Enable-EntraDirectoryRole -RoleTemplateId $guestRole.Id

DeletedDateTime Id                                   Description                                      DisplayName   RoleTemplateId
--------------- --                                   -----------                                      -----------   --------------
                b5baa59b-86ab-4053-ac3a-0396116d1924 Guest Inviter has access to invite guest users.  Guest Inviter 92ed04bf-c94a-4b82-9729-b799a7a4c178

L’exemple montre comment activer le rôle d’annuaire.

Vous pouvez utiliser Get-EntraDirectoryRoleTemplate pour récupérer un rôle d’annuaire spécifique à activer.

  • RoleTemplateId spécifie l’ID du modèle de rôle à activer.

Paramètres

-RoleTemplateId

ID du modèle de rôle à activer.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

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.

Notes