Afficher un rôle
S’applique à : Exchange Server 2013
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 2013, 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.
Souhaitez-vous rechercher les autres tâches de gestion relatives aux rôles ? Consultez la rubrique Autorisations avancées.
Ce qu'il faut savoir avant de commencer
Durée d'exécution estimée de chaque procédure : 5 minutes
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, consultez Entrée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.
Vous devez utiliser l'environnement de ligne de commande Exchange Management Shell pour effectuer ces procédures.
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 :
Pour des informations sur les raccourcis clavier applicables aux procédures de cette rubrique, voir Raccourcis clavier dans Exchange 2013Raccourcis clavier dans le Centre d'administration Exchange.
Conseil
Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez les forums de Exchange Server.
Afficher un rôle de gestion spécifique
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
Vous pouvez afficher la liste de tous les rôles de gestion dans votre organisation en ne spécifiant aucun rôle lorsque vous exécutez l’applet de commande Get-ManagementRole . Par défaut, le nom de rôle et le type de rôle de chaque rôle sont inclus 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
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
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’inclure le paramètre Cmdlet . Si vous incluez le paramètre Cmdlet , seuls les rôles qui contiennent les paramètres que vous spécifiez sur l’applet de commande que vous spécifiez sont retournés. Si vous n’incluez pas le paramètre Cmdlet , les rôles qui contiennent les paramètres que vous spécifiez, quelle que soit l’applet de commande sur laquelle ils se trouvent, sont retourné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 retourne une liste de rôles qui contiennent les paramètres de base de données et de serveur , indépendamment des applets de commande sur lesquelles ils existent.
Get-ManagementRole -CmdletParameters Database, Server
Cet exemple retourne une liste de rôles pour lesquels le paramètre EmailAddresses existe uniquement sur l’applet de commande Set-Mailbox .
Get-ManagementRole -Cmdlet Set-Mailbox -CmdletParameters EmailAddresses
Vous pouvez également utiliser le caractère générique (*) avec les paramètres Cmdlet ou CmdletParameters pour faire correspondre les noms d’applets de commande ou de paramètres partiels.
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
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 retourne une liste de rôles en fonction du type de UmMailboxes
rôle.
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
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
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 à l’applet de commande Get-ManagementRole de récurser chaque relation parent/enfant qu’elle trouve jusqu’à ce qu’elle atteigne 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.