Get-ManagementRole
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’autre.
La cmdlet Get-ManagementRole permet d'afficher les rôles de gestion qui ont été créés dans votre organisation.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
GetChildren
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-GetChildren]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Recurse
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-Recurse]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Identity
Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Cmdlet <String>]
[-CmdletParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Script
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre Cmdlet renvoie la liste de tous les rôles qui incluent la cmdlet spécifiée.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CmdletParameters
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre CmdletParameters retourne une liste de tous les rôles incluant le(s) paramètre(s) spécifié(s). Vous pouvez spécifier plus d'un paramètre en séparant chaque paramètre par une virgule. Si vous spécifiez plusieurs paramètres, seuls les rôles incluant tous les paramètres spécifiés seront retournés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».
Propriétés du paramètre
| Type: | Fqdn |
| 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 |
-GetChildren
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre GetChildren récupère la liste de tous les rôles créés sur la base du rôle parent spécifié dans le paramètre Identity. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Seuls les rôles enfants immédiats du rôle parent sont inclus dans les résultats.
Vous pouvez utiliser ce commutateur uniquement avec les paramètres Identity et RoleType.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
GetChildren
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre Identity spécifie le rôle que vous souhaitez afficher. Si le rôle que vous souhaitez afficher contient des espaces, mettez-le entre guillemets (« »). Vous pouvez utiliser le caractère générique (*) et un nom de rôle partiel pour rechercher plusieurs rôles.
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés du paramètre
| Type: | RoleIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
GetChildren
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
Recurse
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
Identity
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
Script
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Recurse
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre Recurse récupère la liste de tous les rôles créés sur la base du rôle parent spécifié dans le paramètre Identity. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Le rôle spécifié dans le paramètre Identity, ses rôles enfants et leurs enfants sont renvoyés.
Vous pouvez utiliser ce commutateur uniquement avec les paramètres Identity et RoleType.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Recurse
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RoleType
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre RoleType renvoie une liste de rôles correspondant au type de rôle spécifié. Pour obtenir la liste des types de rôles valides, consultez Présentation des rôles de gestion.
Propriétés du paramètre
| Type: | RoleType |
| 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 |
-Script
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre Script renvoie une liste de tous les rôles qui incluent le script spécifié.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Script
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ScriptParameters
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Sécurité & Conformité, Sécurité intégrée module complémentaire pour les boîtes aux lettres locales
Le paramètre ScriptParameters retourne une liste de tous les rôles incluant le(s) paramètre(s) spécifié(s). Vous pouvez spécifier plus d'un paramètre en séparant chaque paramètre par une virgule. Si vous spécifiez plusieurs paramètres, seuls les rôles incluant tous les paramètres spécifiés seront retournés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Script
| 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.
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.