Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Используйте командлет Get-ManagementRole для просмотра ролей управления, которые были созданы в организации.

Синтаксис


Get-ManagementRole [-Identity <RoleIdParameter>] [-Cmdlet <String>] [-CmdletParameters <String[]>] [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-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 \| ResetPassword \| AuditLogs \| RetentionManagement \| SupportDiagnostics \| MailboxSearch \| LegalHold \| MailTips \| PublicFolderReplication \| ActiveDirectoryPermissions \| UMPrompts \| Migration \| DataCenterOperations \| TransportHygiene \| TransportQueues \| Supervision \| CmdletExtensionAgents \| OrganizationConfiguration \| OrganizationClientAccess \| ExchangeConnectors \| MailboxImportExport \| ViewOnlyCentralAdminManagement \| ViewOnlyCentralAdminSupport \| ViewOnlyRoleManagement \| Reporting \| TransportAgents \| InformationRightsManagement \| LawEnforcementRequests \| MyDiagnostics>]

Get-ManagementRole [-Identity <RoleIdParameter>]
[-Cmdlet <String>] [-CmdletParameters <String[]>]
[-DomainController <Fqdn>] [-Organization
<OrganizationIdParameter>] [-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 | ResetPassword |
AuditLogs | RetentionManagement | SupportDiagnostics |
MailboxSearch | LegalHold | MailTips | PublicFolderReplication |
ActiveDirectoryPermissions | UMPrompts | Migration |
DataCenterOperations | TransportHygiene | TransportQueues |
Supervision | CmdletExtensionAgents | OrganizationConfiguration |
OrganizationClientAccess | ExchangeConnectors | MailboxImportExport
| ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport |
ViewOnlyRoleManagement | Reporting | TransportAgents |
InformationRightsManagement | LawEnforcementRequests |
MyDiagnostics>]


Get-ManagementRole -Identity <RoleIdParameter> -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-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 \| ResetPassword \| AuditLogs \| RetentionManagement \| SupportDiagnostics \| MailboxSearch \| LegalHold \| MailTips \| PublicFolderReplication \| ActiveDirectoryPermissions \| UMPrompts \| Migration \| DataCenterOperations \| TransportHygiene \| TransportQueues \| Supervision \| CmdletExtensionAgents \| OrganizationConfiguration \| OrganizationClientAccess \| ExchangeConnectors \| MailboxImportExport \| ViewOnlyCentralAdminManagement \| ViewOnlyCentralAdminSupport \| ViewOnlyRoleManagement \| Reporting \| TransportAgents \| InformationRightsManagement \| LawEnforcementRequests \| MyDiagnostics>]

Get-ManagementRole -Identity <RoleIdParameter>
-GetChildren <SwitchParameter> [-DomainController
<Fqdn>] [-Organization <OrganizationIdParameter>]
[-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 | ResetPassword |
AuditLogs | RetentionManagement | SupportDiagnostics |
MailboxSearch | LegalHold | MailTips | PublicFolderReplication |
ActiveDirectoryPermissions | UMPrompts | Migration |
DataCenterOperations | TransportHygiene | TransportQueues |
Supervision | CmdletExtensionAgents | OrganizationConfiguration |
OrganizationClientAccess | ExchangeConnectors | MailboxImportExport
| ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport |
ViewOnlyRoleManagement | Reporting | TransportAgents |
InformationRightsManagement | LawEnforcementRequests |
MyDiagnostics>]


Get-ManagementRole -Identity <RoleIdParameter> -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-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 \| ResetPassword \| AuditLogs \| RetentionManagement \| SupportDiagnostics \| MailboxSearch \| LegalHold \| MailTips \| PublicFolderReplication \| ActiveDirectoryPermissions \| UMPrompts \| Migration \| DataCenterOperations \| TransportHygiene \| TransportQueues \| Supervision \| CmdletExtensionAgents \| OrganizationConfiguration \| OrganizationClientAccess \| ExchangeConnectors \| MailboxImportExport \| ViewOnlyCentralAdminManagement \| ViewOnlyCentralAdminSupport \| ViewOnlyRoleManagement \| Reporting \| TransportAgents \| InformationRightsManagement \| LawEnforcementRequests \| MyDiagnostics>]

Get-ManagementRole -Identity <RoleIdParameter>
-Recurse <SwitchParameter> [-DomainController <Fqdn>]
[-Organization <OrganizationIdParameter>] [-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 | ResetPassword |
AuditLogs | RetentionManagement | SupportDiagnostics |
MailboxSearch | LegalHold | MailTips | PublicFolderReplication |
ActiveDirectoryPermissions | UMPrompts | Migration |
DataCenterOperations | TransportHygiene | TransportQueues |
Supervision | CmdletExtensionAgents | OrganizationConfiguration |
OrganizationClientAccess | ExchangeConnectors | MailboxImportExport
| ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport |
ViewOnlyRoleManagement | Reporting | TransportAgents |
InformationRightsManagement | LawEnforcementRequests |
MyDiagnostics>]


`Get-ManagementRole [-Identity <RoleIdParameter>] [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-Script <String>] [-ScriptParameters <String[]>]`

Параметры

Параметр	Обязательный	Тип	Описание
GetChildren	Обязательный	System.Management.Automation.SwitchParameter	Параметр GetChildren извлекает список всех ролей, которые были созданы на основании родительской роли, заданной с помощью параметра Identity. Включены только непосредственные дочерние роли для родительской роли. Параметр GetChildren можно использовать только вместе с параметрами Identity и RoleType.
Identity	Обязательный	Microsoft.Exchange.Configuration.Tasks.RoleIdParameter	Параметр Identity указывает роль, которую необходимо просмотреть. Если требуемая роль содержит пробелы, ее имя необходимо заключить в кавычки ("). Для выбора нескольких ролей возможно использование подстановочного символа (`*`) или частичное указание имени роли.
Recurse	Обязательный	System.Management.Automation.SwitchParameter	Параметр Recurse извлекает список всех ролей, которые были созданы на основании родительской роли, заданной с помощью параметра Identity. Возвращается роль, указанная в параметре Identity, а также дочерние роли и их дочерние элементы. Параметр Recurse можно использовать только вместе с параметрами Identity и RoleType.
Cmdlet	Необязательный	System.String	Параметр Cmdlet возвращает список всех ролей, содержащих указанный командлет.
CmdletParameters	Необязательный	System.String[]	Параметр CmdletParameters возвращает список всех ролей, содержащих указанный параметр или параметры. Можно указать несколько параметров, отделяя каждый запятой. Если указано несколько параметров, будут возвращены только те роли, которые содержат все указанные параметры.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn
Organization	Необязательный	Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter
RoleType	Необязательный	Microsoft.Exchange.Data.Directory.SystemConfiguration.RoleType	Параметр RoleType возвращает список ролей, совпадающих с указанным типом роли. Список действительных типов роли см. в разделе Общие сведения о ролях управления.
Script	Необязательный	System.String	Параметр Script возвращает список всех ролей, содержащих указанный сценарий.
ScriptParameters	Необязательный	System.String[]	Параметр ScriptParameters возвращает список всех ролей, содержащих указанный параметр или параметры. Можно указать несколько параметров, отделяя каждый запятой. Если указано несколько параметров, будут возвращены только те роли, которые содержат все указанные параметры.

Подробное описание

Просмотр ролей управления осуществляется несколькими способами: начиная от перечисления всех ролей организации до перечисления только дочерних ролей указанной родительской роли. Подробные сведения об указанной роли можно также просмотреть путем направления данных, полученных из командлета Get-ManagementRole, в командлет Format-List.

Дополнительные сведения о ролях управления см. в разделе Общие сведения о ролях управления.

Подраздел «Роли управления» в разделе Разрешения управления ролями.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка	Описание

Примеры

ПРИМЕР 1

В примере выводится список всех ролей, созданных в организации.

	Скопировать код
Get-ManagementRole

ПРИМЕР 2

В примере выводится список всех ролей, являющихся дочерними элементами роли управления «Mail Recipients». Команда выполняет рекурсивный запрос всех дочерних ролей указанной родительской роли. Рекурсивный запрос позволяет обнаружить все дочерние роли непосредственных дочерних элементов до последней роли в иерархии. Родительская роль также возвращается в рекурсивном списке.

	Скопировать код
Get-ManagementRole "Mail Recipients" -Recurse

ПРИМЕР 3

В примере приведены роли, содержащие параметр Identity и параметр Database. Не возвращаются роли, содержащие только один параметр.

	Скопировать код
Get-ManagementRole -CmdletParameters Identity, Database

ПРИМЕР 4

В этом примере выводится список всех ролей с типом UnScopedTopLevel. Эти роли содержат пользовательские сценарии или командлеты, не относящиеся к Exchange.

	Скопировать код
Get-ManagementRole -RoleType UnScopedTopLevel

ПРИМЕР 5

В этом примере производится получение роли «Transport Rules», а полученные сведения командлета Get-ManagementRole передаются в командлет Format-List. Затем в командлете Format-List отображаются только свойства Name и RoleType роли «Transport Rules». Дополнительные сведения о конвейере и командлете Format-List см. в разделах Передача по конвейеру и Работа с выходными данными команды.

	Скопировать код
Get-ManagementRole "Transport Rules" \| Format-List Name, RoleType

ПРИМЕР 6

В этом примере выводится список непосредственных дочерних элементов роли «Mail Recipients». Возвращаются только те дочерние роли, родительской ролью которых является роль «Mail Recipients». Роль «Mail Recipients» не выводится в списке.

	Скопировать код
Get-ManagementRole "Mail Recipients" -GetChildren