Get-ManagementRole

Syntax

Get-ManagementRole
   [-Identity] <RoleIdParameter>
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Get-ManagementRole
   [-Identity] <RoleIdParameter>
   [-Recurse]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Get-ManagementRole
   [[-Identity] <RoleIdParameter>]
   [-Cmdlet <String>]
   [-CmdletParameters <String[]>]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Get-ManagementRole
   [[-Identity] <RoleIdParameter>]
   [-Script <String>]
   [-ScriptParameters <String[]>]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Description

Vous pouvez afficher les rôles de gestion de plusieurs façons : en répertoriant tous les rôles de votre organisation ou en répertoriant uniquement les rôles enfants d'un rôle parent spécifié. Vous pouvez également afficher les détails d'un rôle spécifique en transférant la sortie de la cmdlet Get-ManagementRole à la cmdlet Format-List.

Pour plus d'informations sur les rôles de gestion, voir Présentation des rôles de gestion.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Get-ManagementRole

Cet exemple répertorie tous les rôles qui ont été créés dans votre organisation.

Exemple 2

Get-ManagementRole "Mail Recipients" -Recurse

Cet exemple répertorie tous les rôles enfants du rôle de gestion Destinataires de message. La commande exécute une requête récursive de tous les rôles enfants du rôle parent spécifié. Cette requête récursive trouve chaque rôle enfant, depuis les enfants directs du parent jusqu'au dernier rôle enfant dans la hiérarchie. Dans une liste récursive, le rôle parent est également retourné dans la liste.

Exemple 3

Get-ManagementRole -CmdletParameters Identity, Database

Cet exemple répertorie tous les rôles contenant à la fois les paramètres Identity et Database. Les rôles contenant uniquement l'un des deux paramètres ne sont pas retournés.

Exemple 4

Get-ManagementRole -RoleType UnScopedTopLevel

Cet exemple répertorie tous les rôles ayant le type UnScopedTopLevel. Ces rôles contiennent des scripts personnalisés ou des applets de commande non-Exchange.

Exemple 5

Get-ManagementRole "Transport Rules" | Format-List Name, RoleType

Cet exemple récupère uniquement le rôle règles de transport et transmet la sortie de la cmdlet Get-ManagementRole à la cmdlet Format-List. La cmdlet Format-List affiche ensuite uniquement les propriétés Name et RoleType du rôle règles de transport. Pour plus d’informations sur le pipeline et l’applet de commande Format-List, consultez À propos des pipelines et Utilisation de la sortie de commande.

Exemple 6

Get-ManagementRole "Mail Recipients" -GetChildren

Cet exemple répertorie les enfants directs du rôle Destinataires de message. Seuls les rôles enfants ayant Destinataires de message comme rôle parent sont retournés. Le rôle Destinataires de message n'est pas retourné dans la liste.

Paramètres

-Cmdlet

-CmdletParameters

-DomainController

-GetChildren

-Identity

-Recurse

-RoleType

-Script

-ScriptParameters

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.