Get-ManagementRole

 

S’applique à :Exchange Online, Exchange Server 2016, Office 365 Security & Compliance Center

Dernière rubrique modifiée :2017-07-12

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. 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 SyntaxeSyntaxe de cmdlet Exchange.

Get-ManagementRole [-Cmdlet <String>] [-CmdletParameters <String[]>] [-Identity <RoleIdParameter>] [-RoleType <Custom | UnScoped | OrganizationManagement | RecipientManagement | ViewOnlyOrganizationManagement | DistributionGroupManagement | MyDistributionGroups | MyDistributionGroupMembership | UmManagement | RecordsManagement | MyBaseOptions | UmRecipientManagement | HelpdeskRecipientManagement | GALSynchronizationManagement | ApplicationImpersonation | UMPromptManagement | PartnerDelegatedTenantManagement | DiscoveryManagement | CentralAdminManagement | UnScopedRoleManagement | MyContactInformation | MyProfileInformation | MyVoiceMail | MyTextMessaging | MyMailSubscriptions | MyRetentionPolicies | MyOptions | MailRecipients | FederatedSharing | DatabaseAvailabilityGroups | Databases | PublicFolders | AddressLists | RecipientPolicies | DisasterRecovery | Monitoring | DatabaseCopies | UnifiedMessaging | Journaling | RemoteAndAcceptedDomains | EmailAddressPolicies | TransportRules | SendConnectors | EdgeSubscriptions | OrganizationTransportSettings | ExchangeServers | ExchangeVirtualDirectories | ExchangeServerCertificates | POP3AndIMAP4Protocols | ReceiveConnectors | UMMailboxes | UserOptions | SecurityGroupCreationAndMembership | MailRecipientCreation | MessageTracking | RoleManagement | ViewOnlyRecipients | ViewOnlyConfiguration | DistributionGroups | MailEnabledPublicFolders | MoveMailboxes | WorkloadManagement | ResetPassword | AuditLogs | RetentionManagement | SupportDiagnostics | MailboxSearch | LegalHold | MailTips | PublicFolderReplication | ActiveDirectoryPermissions | UMPrompts | Migration | DataCenterOperations | TransportHygiene | TransportQueues | Supervision | CmdletExtensionAgents | OrganizationConfiguration | OrganizationClientAccess | ExchangeConnectors | MailboxImportExport | ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport | ViewOnlyRoleManagement | Reporting | ViewOnlyAuditLogs | TransportAgents | DataCenterDestructiveOperations | InformationRightsManagement | LawEnforcementRequests | MyDiagnostics | MyMailboxDelegation | TeamMailboxes | MyTeamMailboxes | ActiveMonitoring | DataLossPrevention | MyFacebookEnabled | MyLinkedInEnabled | UserApplication | ArchiveApplication | LegalHoldApplication | OfficeExtensionApplication | TeamMailboxLifecycleApplication | CentralAdminCredentialManagement | PersonallyIdentifiableInformation | MailboxSearchApplication | MyMarketplaceApps | MyCustomApps | OrgMarketplaceApps | OrgCustomApps | ExchangeCrossServiceIntegration | NetworkingManagement | AccessToCustomerDataDCOnly | DatacenterOperationsDCOnly | OutlookSupportTier0 | O365SupportViewConfig | OutlookSupportTier1 | OutlookSupportTier3 | MeetingGraphApplication | ComplianceSearch | CaseManagement | Export | Hold | Preview | OutlookSupportTier9 | MyReadWriteMailboxApps | Review | SearchAndPurge | SupervisoryReviewAdmin | ServiceAssuranceView | OutlookSupportPartnersTier0 | OutlookSupportPartnersTier1 | OutlookSupportPartnersTier3 | OutlookSupportPartnersTier9 | DatacenterMailboxManagement>] <COMMON PARAMETERS>

Get-ManagementRole [-Identity <RoleIdParameter>] [-Script <String>] [-ScriptParameters <String[]>] <COMMON PARAMETERS>

Get-ManagementRole -GetChildren <SwitchParameter> -Identity <RoleIdParameter> [-RoleType <Custom | UnScoped | OrganizationManagement | RecipientManagement | ViewOnlyOrganizationManagement | DistributionGroupManagement | MyDistributionGroups | MyDistributionGroupMembership | UmManagement | RecordsManagement | MyBaseOptions | UmRecipientManagement | HelpdeskRecipientManagement | GALSynchronizationManagement | ApplicationImpersonation | UMPromptManagement | PartnerDelegatedTenantManagement | DiscoveryManagement | CentralAdminManagement | UnScopedRoleManagement | MyContactInformation | MyProfileInformation | MyVoiceMail | MyTextMessaging | MyMailSubscriptions | MyRetentionPolicies | MyOptions | MailRecipients | FederatedSharing | DatabaseAvailabilityGroups | Databases | PublicFolders | AddressLists | RecipientPolicies | DisasterRecovery | Monitoring | DatabaseCopies | UnifiedMessaging | Journaling | RemoteAndAcceptedDomains | EmailAddressPolicies | TransportRules | SendConnectors | EdgeSubscriptions | OrganizationTransportSettings | ExchangeServers | ExchangeVirtualDirectories | ExchangeServerCertificates | POP3AndIMAP4Protocols | ReceiveConnectors | UMMailboxes | UserOptions | SecurityGroupCreationAndMembership | MailRecipientCreation | MessageTracking | RoleManagement | ViewOnlyRecipients | ViewOnlyConfiguration | DistributionGroups | MailEnabledPublicFolders | MoveMailboxes | WorkloadManagement | ResetPassword | AuditLogs | RetentionManagement | SupportDiagnostics | MailboxSearch | LegalHold | MailTips | PublicFolderReplication | ActiveDirectoryPermissions | UMPrompts | Migration | DataCenterOperations | TransportHygiene | TransportQueues | Supervision | CmdletExtensionAgents | OrganizationConfiguration | OrganizationClientAccess | ExchangeConnectors | MailboxImportExport | ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport | ViewOnlyRoleManagement | Reporting | ViewOnlyAuditLogs | TransportAgents | DataCenterDestructiveOperations | InformationRightsManagement | LawEnforcementRequests | MyDiagnostics | MyMailboxDelegation | TeamMailboxes | MyTeamMailboxes | ActiveMonitoring | DataLossPrevention | MyFacebookEnabled | MyLinkedInEnabled | UserApplication | ArchiveApplication | LegalHoldApplication | OfficeExtensionApplication | TeamMailboxLifecycleApplication | CentralAdminCredentialManagement | PersonallyIdentifiableInformation | MailboxSearchApplication | MyMarketplaceApps | MyCustomApps | OrgMarketplaceApps | OrgCustomApps | ExchangeCrossServiceIntegration | NetworkingManagement | AccessToCustomerDataDCOnly | DatacenterOperationsDCOnly | OutlookSupportTier0 | O365SupportViewConfig | OutlookSupportTier1 | OutlookSupportTier3 | MeetingGraphApplication | ComplianceSearch | CaseManagement | Export | Hold | Preview | OutlookSupportTier9 | MyReadWriteMailboxApps | Review | SearchAndPurge | SupervisoryReviewAdmin | ServiceAssuranceView | OutlookSupportPartnersTier0 | OutlookSupportPartnersTier1 | OutlookSupportPartnersTier3 | OutlookSupportPartnersTier9 | DatacenterMailboxManagement>] <COMMON PARAMETERS>

Get-ManagementRole -Identity <RoleIdParameter> -Recurse <SwitchParameter> [-RoleType <Custom | UnScoped | OrganizationManagement | RecipientManagement | ViewOnlyOrganizationManagement | DistributionGroupManagement | MyDistributionGroups | MyDistributionGroupMembership | UmManagement | RecordsManagement | MyBaseOptions | UmRecipientManagement | HelpdeskRecipientManagement | GALSynchronizationManagement | ApplicationImpersonation | UMPromptManagement | PartnerDelegatedTenantManagement | DiscoveryManagement | CentralAdminManagement | UnScopedRoleManagement | MyContactInformation | MyProfileInformation | MyVoiceMail | MyTextMessaging | MyMailSubscriptions | MyRetentionPolicies | MyOptions | MailRecipients | FederatedSharing | DatabaseAvailabilityGroups | Databases | PublicFolders | AddressLists | RecipientPolicies | DisasterRecovery | Monitoring | DatabaseCopies | UnifiedMessaging | Journaling | RemoteAndAcceptedDomains | EmailAddressPolicies | TransportRules | SendConnectors | EdgeSubscriptions | OrganizationTransportSettings | ExchangeServers | ExchangeVirtualDirectories | ExchangeServerCertificates | POP3AndIMAP4Protocols | ReceiveConnectors | UMMailboxes | UserOptions | SecurityGroupCreationAndMembership | MailRecipientCreation | MessageTracking | RoleManagement | ViewOnlyRecipients | ViewOnlyConfiguration | DistributionGroups | MailEnabledPublicFolders | MoveMailboxes | WorkloadManagement | ResetPassword | AuditLogs | RetentionManagement | SupportDiagnostics | MailboxSearch | LegalHold | MailTips | PublicFolderReplication | ActiveDirectoryPermissions | UMPrompts | Migration | DataCenterOperations | TransportHygiene | TransportQueues | Supervision | CmdletExtensionAgents | OrganizationConfiguration | OrganizationClientAccess | ExchangeConnectors | MailboxImportExport | ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport | ViewOnlyRoleManagement | Reporting | ViewOnlyAuditLogs | TransportAgents | DataCenterDestructiveOperations | InformationRightsManagement | LawEnforcementRequests | MyDiagnostics | MyMailboxDelegation | TeamMailboxes | MyTeamMailboxes | ActiveMonitoring | DataLossPrevention | MyFacebookEnabled | MyLinkedInEnabled | UserApplication | ArchiveApplication | LegalHoldApplication | OfficeExtensionApplication | TeamMailboxLifecycleApplication | CentralAdminCredentialManagement | PersonallyIdentifiableInformation | MailboxSearchApplication | MyMarketplaceApps | MyCustomApps | OrgMarketplaceApps | OrgCustomApps | ExchangeCrossServiceIntegration | NetworkingManagement | AccessToCustomerDataDCOnly | DatacenterOperationsDCOnly | OutlookSupportTier0 | O365SupportViewConfig | OutlookSupportTier1 | OutlookSupportTier3 | MeetingGraphApplication | ComplianceSearch | CaseManagement | Export | Hold | Preview | OutlookSupportTier9 | MyReadWriteMailboxApps | Review | SearchAndPurge | SupervisoryReviewAdmin | ServiceAssuranceView | OutlookSupportPartnersTier0 | OutlookSupportPartnersTier1 | OutlookSupportPartnersTier3 | OutlookSupportPartnersTier9 | DatacenterMailboxManagement>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-DomainController <Fqdn>]

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

Get-ManagementRole

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.

Get-ManagementRole "Mail Recipients" -Recurse

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.

Get-ManagementRole -CmdletParameters Identity, Database

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

Get-ManagementRole -RoleType UnScopedTopLevel

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 traitement en pipeline et la cmdlet Format-List, consultez les rubriques Traitement en pipeline et Utilisation de la sortie de la commande.

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

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.

Get-ManagementRole "Mail Recipients" -GetChildren

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, consultez la rubrique Présentation des rôles de gestion.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 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.

 

Paramètre Obligatoire Type Description

GetChildren

Obligatoire

System.Management.Automation.SwitchParameter

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. Seuls les rôles enfants directs du rôle parent sont inclus. Il est possible d'utiliser le paramètre GetChildren uniquement avec les paramètres Identity et RoleType.

Recurse

Obligatoire

System.Management.Automation.SwitchParameter

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. Le rôle spécifié dans le paramètre Identity, ses rôles enfants et leurs enfants sont renvoyés. Il est possible d'utiliser le paramètre Recurse uniquement avec les paramètres Identity et RoleType.

Cmdlet

Facultatif

System.String

Le paramètre Cmdlet renvoie la liste de tous les rôles qui incluent la cmdlet spécifiée.

CmdletParameters

Facultatif

System.String[]

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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.RoleIdParameter

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.

RoleType

Facultatif

Microsoft.Exchange.Data.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ôle valides, voir Présentation des rôles de gestion.

Script

Facultatif

System.String

Le paramètre Script renvoie une liste de tous les rôles qui incluent le script spécifié.

ScriptParameters

Facultatif

System.String[]

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.

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.

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.

 
Afficher: