Afficher un rôle

S'applique à : Exchange Server 2010

Dernière rubrique modifiée : 2009-09-21

Les rôles de gestion peuvent être répertoriés de différentes façons en fonction des informations que vous souhaitez obtenir. Par exemple, vous pouvez choisir de renvoyer uniquement les rôles d’un type de rôle donné, les rôles qui contiennent uniquement des cmdlets et des paramètres spécifiques ou encore afficher les détails d’un rôle de gestion précis. Pour plus d’informations sur les rôles de gestion dans Microsoft Exchange Server 2010, voir Présentation des rôles de gestion.

Pour afficher la liste de toutes les entrées de rôle de gestion d’un rôle, consultez Afficher les entrées de rôle.

Vous devez utiliser le Shell pour afficher les rôles de gestion.

Souhaitez-vous rechercher les autres tâches de gestion relatives aux rôles ? Consultez la rubrique Gestion des autorisations avancées.

Conditions préalables

Cette rubrique décrit l’utilisation du pipelining et des cmdlets Format-List et Format-Table. Pour plus d’informations sur ces concepts, consultez les rubriques suivantes :

• Traitement en pipeline
• Utilisation de la sortie d’une commande

Que voulez-vous faire ?

• Afficher un rôle de gestion spécifique
• Liste de tous les rôles de gestion
• Liste des rôles de gestion contenant une cmdlet spécifique
• Liste des rôles de gestion contenant un paramètre spécifique
• Liste des rôles de gestion d’un type de rôle spécifique
• Liste des rôles enfants immédiats d’un rôle parent
• Liste de tous les rôles enfants sous un rôle parent

Remarque :
Vous ne pouvez pas utiliser l’EMC pour afficher les rôles.

Afficher un rôle de gestion spécifique

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez afficher les détails d’un rôle spécifique en récupérant un rôle spécifique à l’aide de la cmdlet Get-ManagementRole et en canalisant la sortie de la cmdlet Format-List.

Pour afficher les détails d’un rôle spécifique, utilisez la syntaxe suivante.

Get-ManagementRole <role name> | Format-List

Cet exemple indique comment récupérer les détails du rôle de gestion Destinataires de messagerie.

Get-ManagementRole "Mail Recipients" | Format-List

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.

Liste de tous les rôles de gestion

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez afficher la liste de tous les rôles de gestion de votre organisation. Pour cela, ne spécifiez aucun rôle lorsque vous exécutez la commande Get-ManagementRole. Par défaut, le nom et le type de chaque rôle sont compris dans les résultats.

Cet exemple renvoie une liste de tous les rôles de votre organisation.

Get-ManagementRole

Pour renvoyer une liste des propriétés spécifiques à tous les rôles de votre organisation, vous pouvez canaliser les résultats de la cmdlet Format-Table et spécifier les propriétés de votre choix dans la liste des résultats. Utilisez la syntaxe suivante :

Get-ManagementRole | Format-Table <property 1>, <property 2...>

Cet exemple renvoie la liste de tous les rôles de votre organisation et comprend la propriété Name ainsi que toute propriété contenant le mot Implicit au début de son nom.

Get-ManagementRole | Format-Table Name, Implicit*

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.

Liste des rôles de gestion contenant une cmdlet spécifique

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez renvoyer la liste des rôles contenant un cmdlet que vous indiquez à l’aide du paramètre Cmdlet avec la cmdlet Get-ManagementRole.

Pour renvoyer la liste des rôles contenant la cmdlet que vous indiquez, utilisez la syntaxe suivante.

Get-ManagementRole -Cmdlet <cmdlet>

Cet exemple indique comment renvoyer la liste de rôles contenant la cmdlet New-Mailbox.

Get-ManagementRole -Cmdlet New-Mailbox

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.

Liste des rôles de gestion contenant un paramètre spécifique

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez renvoyer la liste des rôles contenant un ou plusieurs paramètres que vous indiquez à l’aide du paramètre CmdletParameters avec la cmdlet Get-ManagementRole. Seuls les rôles qui contiennent tous les paramètres que vous spécifiez sont renvoyés.

Lorsque vous utilisez le paramètre CmdletParameters, vous pouvez choisir d’utiliser le paramètre Cmdlet. Si vous incluez le paramètre Cmdlet, seuls les rôles contenant les paramètres que vous spécifiez dans la cmdlet sont renvoyés. Si vous n’incluez pas le paramètre Cmdlet, les rôles contenant les paramètres que vous spécifiez, indépendamment de la cmldet à laquelle ils sont associés, sont renvoyés.

Pour renvoyer la liste des rôles contenant les paramètres que vous indiquez, utilisez la syntaxe suivante.

Get-ManagementRole [-Cmdlet <cmdlet>] -CmdletParameters <parameter 1>, <parameter 2...>

Cet exemple renvoie la liste des rôles contenant les paramètres Database et Server, indépendamment de la cmdlet à laquelle ils sont associés.

Get-ManagementRole -CmdletParameters Database, Server

Cet exemple renvoie la liste des rôles lorsque le paramètre EmailAddresses est uniquement spécifié dans la cmdlet Set-Mailbox.

Get-ManagementRole -Cmdlet Set-Mailbox -CmdletParameters EmailAddresses

Vous pouvez également utiliser le caractère générique (*) avec le paramètre Cmdlet ou CmdletParameters pour faire correspondre les noms partiels de cmdlet ou de paramètre.

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.

Liste des rôles de gestion d’un type de rôle spécifique

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez renvoyer la liste des rôles en fonction d’un type de rôle donné à l’aide du paramètre RoleType avec la cmdlet Get-ManagementRole.

Pour renvoyer la liste des rôles correspondant au type de rôle que vous indiquez, utilisez la syntaxe suivante.

Get-ManagementRole -RoleType <roletype>

Cet exemple indique comment renvoyer une liste de rôles en fonction du type de rôle UmMailboxes.

Get-ManagementRole -RoleType UmMailboxes

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.

Liste des rôles enfants immédiats d’un rôle parent

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez renvoyer la liste des rôles qui sont les enfants immédiats d’un rôle parent à l’aide du paramètre GetChildren avec la cmdlet Get-ManagementRole. Seuls les rôles qui contiennent le rôle que vous spécifiez comme rôle parent sont renvoyés.

Pour renvoyer la liste des rôles enfants immédiats d’un rôle parent, utilisez la syntaxe suivante.

Get-ManagementRole <parent role name> -GetChildren

Cet exemple présente le renvoi d’une liste d’enfants immédiats du rôle Récupération après sinistre.

Get-ManagementRole "Disaster Recovery" -GetChildren

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.

Liste de tous les rôles enfants sous un rôle parent

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ée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

Vous pouvez renvoyer la liste de la chaîne complète de rôles, d’un rôle parent spécifié jusqu’au dernier rôle enfant, à l’aide du paramètre Recurse avec la cmdlet Get-ManagementRole. Le paramètre Recurse indique à la cmdlet Get-ManagementRole de parcourir vers le bas chaque relation parent et enfant détectée jusqu’à atteindre le dernier rôle enfant. Le rôle parent est inclus dans la liste renvoyée.

Dans cet exemple, la liste de tous les rôles enfants d’un rôle parent est renvoyée.

Get-ManagementRole <parent role name> -Recurse

Cet exemple présente le renvoi de tous les rôles enfants du rôle Destinataires de messagerie.

Get-ManagementRole "Mail Recipients" -Recurse

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-ManagementRole.