Applies to: Exchange Server 2013, Exchange Online
Topic Last Modified: 2012-06-25
Use the Get-ManagementRole cmdlet to view management roles that have been created in your organization.
For information about the parameter sets in the Syntax section below, see Syntax.
Syntax
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>] <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>] <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>] <COMMON PARAMETERS>
|
COMMON PARAMETERS: [-DomainController <Fqdn>]
[-Organization <OrganizationIdParameter>]
|
Examples
EXAMPLE 1
This example lists all the roles that have been created in your organization.
Copy Code | |
---|---|
Get-ManagementRole |
EXAMPLE 2
This example lists all the roles that are children of the Mail Recipients management role. The command performs a recursive query of all the child roles of the specified parent role. This recursive query finds every child role from the immediate children of the parent to the last child role in the hierarchy. In a recursive list, the parent role is also returned in the list.
Copy Code | |
---|---|
Get-ManagementRole "Mail Recipients" -Recurse |
EXAMPLE 3
This example lists all the roles that contain both the Identity and Database parameters. Roles that contain only one parameter or the other aren't returned.
Copy Code | |
---|---|
Get-ManagementRole -CmdletParameters Identity, Database |
EXAMPLE 4
This example lists all the roles that have a type of
UnScopedTopLevel
. These roles contain custom scripts
or non-Exchange cmdlets.
Copy Code | |
---|---|
Get-ManagementRole -RoleType UnScopedTopLevel |
EXAMPLE 5
This example retrieves only the Transport Rules role and passes the output of the Get-ManagementRole cmdlet to the Format-List cmdlet. The Format-List cmdlet then shows only the Name and RoleType properties of the Transport Rules role. For more information about pipelining and the Format-List cmdlet, see Pipelining and Working with Command Output.
Copy Code | |
---|---|
Get-ManagementRole "Transport Rules" | Format-List Name, RoleType |
EXAMPLE 6
This example lists the immediate children of the Mail Recipients role. Only the child roles that hold the Mail Recipients role as their parent role are returned. The Mail Recipients role isn't returned in the list.
Copy Code | |
---|---|
Get-ManagementRole "Mail Recipients" -GetChildren |
Detailed Description
You can view management roles in several ways, from listing all the roles in your organization to listing only the child roles of a specified parent role. You can also view the details of a specific role by piping the output of the Get-ManagementRole cmdlet to the Format-List cmdlet.
For more information about management roles, see Understanding Management Roles.
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Management roles" entry in the Role Management Permissions topic.
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
GetChildren |
Required |
System.Management.Automation.SwitchParameter |
The GetChildren parameter retrieves a list of all the roles that were created based on the parent role specified in the Identity parameter. Only the immediate child roles of the parent role are included. The GetChildren parameter can only be used with the Identity and RoleType parameters. |
Recurse |
Required |
System.Management.Automation.SwitchParameter |
The Recurse parameter retrieves a list of all the roles that were created based on the parent role specified in the Identity parameter. The role specified in the Identity parameter, its child roles, and their children are returned. The Recurse parameter can only be used with the Identity and RoleType parameters. |
Cmdlet |
Optional |
System.String |
The Cmdlet parameter returns a list of all roles that include the specified cmdlet. |
CmdletParameters |
Optional |
System.String[] |
The CmdletParameters parameter returns a list of all roles that include the specified parameter or parameters. You can specify more than one parameter by separating each parameter with a comma. If you specify multiple parameters, only the roles that include all of the specified parameters are returned. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.RoleIdParameter |
The Identity parameter specifies the role you want to view. If the role you want to view contains spaces, enclose the name in quotation marks ("). You can use the wildcard character (*) and a partial role name to match multiple roles. |
Organization |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
The Organization parameter is reserved for internal Microsoft use. |
RoleType |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RoleType |
The RoleType parameter returns a list of roles that match the specified role type. For a list of valid role types, see Understanding Management Roles. |
Script |
Optional |
System.String |
The Script parameter returns a list of all roles that include the specified script. |
ScriptParameters |
Optional |
System.String[] |
The ScriptParameters parameter returns a list of all roles that include the specified parameter or parameters. You can specify more than one parameter by separating each parameter with a comma. If you specify multiple parameters, only the roles that include all of the specified parameters are returned. |
Input Types
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
Return Types
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.