В этом разделе описывается использование конвейерной передачи и командлетов Format-List и Format-Table. Дополнительные сведения об этих понятиях см. в следующих разделах:

• Передача по конвейеру
  
  
• Работа с выходными данными команды
  
  

• Просмотр определенной роли управления
  
  
• Получение списка всех ролей управления
  
  
• Получение списка ролей управления, содержащих определенный командлет
  
  
• Получение списка ролей управления, содержащих определенный параметр
  
  
• Получение списка ролей управления определенного типа роли
  
  
• Получение списка непосредственных дочерних ролей родительской роли
  
  
• Получение списка всех дочерних ролей ниже родительской роли
  
  

Примечание.
Консоль управления Exchange нельзя использовать для просмотра ролей.

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

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

Чтобы просмотреть подробные сведения об определенной роли, используйте следующий синтаксис.

	Скопировать код
Get-ManagementRole <role name> | Format-List

В этом примере выполняется получение подробных сведений о роли управления «Получатели почты».

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

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.

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

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

В этом примере показано возвращение списка всех ролей в организации.

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

Для возврата списка определенных свойств для всех ролей в организации можно передать результаты выполнения командлета Format-Table и указать свойства, которые должны находиться в списке результатов. Используйте следующий синтаксис.

	Скопировать код
Get-ManagementRole | Format-Table <property 1>, <property 2...>

В данном примере показано возвращение списка всех ролей в организации и включение свойства Имя, а также любого свойства со словом Неявное в начало имени свойства.

	Скопировать код
Get-ManagementRole | Format-Table Name, Implicit*

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.

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

Может быть возвращен список ролей, содержащий командлет, который был указан с помощью параметра Cmdlet командлета Get-ManagementRole.

Для возврата списка ролей, содержащих указанный командлет, используйте следующий синтаксис.

	Скопировать код
Get-ManagementRole -Cmdlet <cmdlet>

В этом примере показано возвращение списка ролей, содержащих командлет New-Mailbox.

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

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.

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

Список ролей, содержащих один или несколько указанных параметров, может быть возвращен с помощью параметра CmdletParameters командлета Get-ManagementRole. Будут возвращены только роли, содержащие указанные параметры.

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

Для возврата списка ролей, содержащих указанные параметры, используйте следующий синтаксис.

	Скопировать код
Get-ManagementRole [-Cmdlet <cmdlet>] -CmdletParameters <parameter 1>, <parameter 2...>

В данном примере показано возвращение списка ролей, содержащих параметры Database и Server, независимо от командлета, в котором они находятся.

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

В данном примере показано возвращение списка ролей, в которых параметр EmailAddresses содержится только в командлете Set-Mailbox.

	Скопировать код
Get-ManagementRole -Cmdlet Set-Mailbox -CmdletParameters EmailAddresses

C параметрами Cmdlet или CmdletParameters можно использовать подстановочный знак (*) для совпадения с частично введенными именами или параметрами командлетов.

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.

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

С помощью параметра RoleType командлета Get-ManagementRole может быть возвращен список ролей, основанный на определенном типе роли.

Для возврата списка ролей, соответствующих указанному типу ролей, используйте следующий синтаксис.

	Скопировать код
Get-ManagementRole -RoleType <roletype>

В данном примере показано возвращение списка ролей, основанного на типе роли UmMailboxes.

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

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.

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

Список непосредственных дочерних ролей указанной родительской роли может быть возвращен с помощью параметра GetChildren командлета Get-ManagementRole. Будут возвращены только роли с указанной родительской ролью.

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

	Скопировать код
Get-ManagementRole <parent role name> -GetChildren

В данном примере выполняется возвращение списка непосредственных дочерних ролей родительской роли «Аварийное восстановление».

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

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.

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

Список всей цепочки ролей от указанной родительской роли до последней дочерней роли может быть возвращен с помощью параметра Recurse командлета Get-ManagementRole. Параметр Recurse указывает командлету Get-ManagementRole обойти все найденные родительские и дочерние отношения, пока не будет достигнута последняя дочерняя роль. Родительская роль включается в список, который будет возвращен.

В данном примере показано возвращение списка всех дочерних ролей родительской роли.

	Скопировать код
Get-ManagementRole <parent role name> -Recurse

В данном примере показано возвращение всех дочерних ролей родительской роли «Получатели почты».

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

Подробные сведения о синтаксисе и параметрах см. в разделе Get-ManagementRole.