Afficher les entrées de rôle
S'applique à : Exchange Server 2010
Dernière rubrique modifiée : 2009-09-21
Chaque entrée de rôle de gestion représente une cmdlet unique ou un script. Les paramètres inclus dans une entrée de rôle déterminent les paramètres sur la cmdlet ou le script auxquels un utilisateur peut accéder.
Les entrées d'identité de rôle sont constituées du nom du rôle de gestion auquel l'entrée de rôle est associée et de la cmdlet ou du script auquel l'entrée de rôle fait référence. Pour plus d'informations sur les entrées de rôle dans Microsoft Exchange Server 2010, voir Présentation des rôles de gestion.
Vous devez utiliser l'environnement de ligne de commande Exchange Management Shell pour afficher les entrées de rôle.
Souhaitez-vous rechercher les autres tâches de gestion associées aux entrées de rôle ? Consultez la rubrique Gestion des autorisations avancées.
Conditions préalables
Cette rubrique utilise le traitement en pipeline, la cmdlet Format-List , des objets et des propriétés. Pour plus d’informations sur ces concepts, consultez les rubriques suivantes :
Que voulez-vous faire ?
- Afficher une liste d'entrées de rôle
- Afficher une liste de toutes les entrées de rôle sur un rôle
- Afficher une liste des rôles contenant une entrée de rôle spécifique
- Afficher une liste ciblée des rôles contenant des entrées de rôle similaires
- Afficher une seule entrée de rôle
- Afficher les paramètres d'une entrée de rôle
Afficher une liste d'entrées de rôle
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, voir « Entrées des rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.
La cmdlet Get-ManagementRoleEntry permet de produire une liste des entrées de rôle. Lorsque vous utilisez la cmdlet Get-ManagementRoleEntry, vous devez spécifier une valeur contenant le nom du rôle qui contient les entrées de rôle que vous souhaitez répertorier et le nom de la cmdlet permettant de les répertorier. En combinant le nom du rôle et le nom de la cmdlet avec le caractère générique (*), vous pouvez obtenir des listes d'entrées de rôle spécifiques ou larges.
Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRoleEntry.
Afficher une liste de toutes les entrées de rôle sur un rôle
Pour afficher une liste des entrées de rôle sur un rôle spécifique, utilisez la syntaxe suivante.
Get-ManagementRoleEntry <role name>\*
Cet exemple extrait toutes les entrées de rôle sur le rôle Recipient Administrators.
Get-ManagementRole "Recipient Administrators\*"
Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRoleEntry.
Afficher une liste des rôles contenant une entrée de rôle spécifique
Pour afficher une liste de tous les rôles contenant une entrée de rôle spécifique, utilisez la syntaxe suivante.
Get-ManagementRoleEntry *\<cmdlet name>
Cet exemple extrait tous les rôles contenant l'entrée de rôle Set-Mailbox.
Get-ManagementRoleEntry *\Set-Mailbox
Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRoleEntry.
Afficher une liste ciblée des rôles contenant des entrées de rôle similaires
Pour afficher une liste des rôles ciblés contenant des cmdlets avec des noms similaires, utilisez la syntaxe suivante.
Get-ManagementRoleEntry *<partial role name>*\*<partial cmdlet name>*
Cet exemple produit une liste des entrées de rôle contenant la chaîne Mailbox et qui sont sur des rôles dont le nom comprend la chaîne Tier 1.
Get-ManagementRoleEntry "*Tier 1*\*Mailbox*"
Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRoleEntry.
Afficher une seule entrée de rôle
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, voir « Entrées des rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.
Pour afficher les détails d'une entrée de rôle, utilisez la syntaxe suivante.
Get-ManagementRoleEntry <role name>\<cmdlet name> | Format-List
Cet exemple extrait les détails de l'entrée de rôle Set-Mailbox sur le rôle Recipient Administrators.
Get-ManagementRoleEntry "Recipient Administrators\Set-Mailbox" | Format-List
S'il n'est pas possible d'afficher tous les paramètres d'une entrée de rôle à l'aide de la cmdlet Format-List, voir « Afficher les paramètres d'une entrée de rôle » plus bas dans cette rubrique.
Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRoleEntry.
Afficher les paramètres d'une entrée de rôle
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, voir « Entrées des rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.
Certaines entrées de rôle contiennent plus de paramètres qu'il n'est possible d'afficher en canalisant les résultats de la cmdlet Get-ManagementRoleEntry vers la cmdlet Format-List. Si vous devez afficher tous les paramètres sur une entrée de rôle, accédez directement à la propriété Parameters de l'objet d'entrée de rôle.
Pour afficher les paramètres stockés dans la propriété Parameters d'un objet d'entrée de rôle, utilisez la syntaxe suivante.
(Get-ManagementRoleEntry <role name>\<cmdlet name>).Parameters
Cet exemple extrait les paramètres sur l'entrée de rôle Set-Mailbox sur le rôle Mail Recipients.
(Get-ManagementRoleEntry "Mail Recipients\Set-Mailbox").Parameters
Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRoleEntry.