Get-ManagementRole
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un 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.
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-ManagementRoleCet exemple répertorie tous les rôles qui ont été créés dans votre organisation.
Exemple 2
Get-ManagementRole "Mail Recipients" -RecurseCet 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, DatabaseCet 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 UnScopedTopLevelCet 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, RoleTypeCet 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" -GetChildrenCet 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
Le paramètre Cmdlet renvoie la liste de tous les rôles qui incluent la cmdlet spécifiée.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-CmdletParameters
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-DomainController
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 ».
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GetChildren
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Identity
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.
| Type: | RoleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Recurse
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-RoleType
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.
| Type: | RoleType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Script
Le paramètre Script renvoie une liste de tous les rôles qui incluent le script spécifié.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-ScriptParameters
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
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.