Get-ManagementRole

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

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

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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>]

Описание

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

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

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-ManagementRole

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

Пример 2

Get-ManagementRole "Mail Recipients" -Recurse

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

Пример 3

Get-ManagementRole -CmdletParameters Identity, Database

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

Пример 4

Get-ManagementRole -RoleType UnScopedTopLevel

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

Пример 5

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

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

Пример 6

Get-ManagementRole "Mail Recipients" -GetChildren

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

Параметры

-Cmdlet

Параметр Cmdlet возвращает список всех ролей, содержащих указанный командлет.

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

Параметр CmdletParameters возвращает список всех ролей, содержащих указанный параметр или параметры. Можно указать несколько параметров, отделяя каждый запятой. Если указано несколько параметров, будут возвращены только те роли, которые содержат все указанные параметры.

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

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, 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

Параметр GetChildren извлекает список всех ролей, которые были созданы на основании родительской роли, заданной с помощью параметра Identity. Указывать значение для этого параметра необязательно.

В результаты включаются только непосредственные дочерние роли родительской роли.

Этот параметр можно использовать только с параметрами Identity и 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

Параметр Identity указывает роль, которую необходимо просмотреть. Если требуемая роль содержит пробелы, ее имя необходимо заключить в кавычки ("). Для выбора нескольких ролей возможно использование подстановочного знака (*) с частичным указанием имени роли.

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

Параметр Recurse извлекает список всех ролей, которые были созданы на основании родительской роли, заданной с помощью параметра Identity. Указывать значение для этого параметра необязательно.

Возвращается роль, указанная в параметре Identity, а также дочерние роли и их дочерние элементы.

Этот параметр можно использовать только с параметрами Identity и 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

Параметр RoleType возвращает список ролей, совпадающих с указанным типом роли. Список допустимых типов ролей см. в разделе Общие сведения о ролях управления.

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

Параметр Script возвращает список всех ролей, содержащих указанный сценарий.

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

Параметр ScriptParameters возвращает список всех ролей, содержащих указанный параметр или параметры. Можно указать несколько параметров, отделяя каждый запятой. Если указано несколько параметров, будут возвращены только те роли, которые содержат все указанные параметры.

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

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.