Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет Get-RoleGroup используется для получения списка групп ролей управления.
Синтаксис
Get-RoleGroup [-Identity <RoleGroupIdParameter>]
[-DomainController <Fqdn>] [-Filter <String>]
[-Organization <OrganizationIdParameter>]
[-ReadFromDomainController <SwitchParameter>] [-ResultSize
<Unlimited>] [-ShowPartnerLinked <SwitchParameter>]
[-SortBy <String>]
|
Параметры
| Параметр | Обязательность | Тип | Описание |
|---|---|---|---|
|
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|
|
Filter |
Необязательный |
System.String |
Параметр Filter указывает, используется ли свойство для фильтрации групп ролей. Возвращаются только группы ролей, которые соответствуют определяемому критерию. Можно выполнять фильтрацию по свойствам
|
|
Identity |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.RoleGroupIdParameter |
Параметр Identity определяет группу ролей, которую необходимо получить. Если имя группы ролей содержит пробелы, его необходимо заключить в кавычки ("). Если параметр Identity не определен, будут возвращены все группы ролей. |
|
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
|
|
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Переключатель ReadFromDomainController указывает, что сведения о группе ролей будут считываться из контроллера домена в домене пользователя. Если командлет Set-AdServerSettings используется для включения команд области в весь лес без использования этого переключателя, сведения о группе ролей могут быть прочитаны из глобального каталога с устаревшей информацией. |
|
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное число
возвращаемых результатов. Если необходимо, чтобы были возвращены
все группы ролей, присвойте данному параметру значение
|
|
ShowPartnerLinked |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ShowPartnerLinked указывает, следует ли
возвращать встроенные группы ролей типа
|
|
SortBy |
Необязательный |
System.String |
Параметр SortBy указывает атрибут, используемый для сортировки результатов. Сортировка может выполняться только по одному атрибуту за раз. Можно выполнять сортировку по атрибуту Name. Результаты сортируются в порядке возрастания. |
Подробное описание
Дополнительные сведения о группах ролей см. в разделе Общие сведения о группах ролей управления.
Запись «Группы ролей» в разделе Разрешения управления ролями.
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Примеры
ПРИМЕР 1
В данном примере показано получение списка групп ролей.
 Скопировать код |
|
|---|---|
Get-RoleGroup |
|
ПРИМЕР 2
В данном примере показано получение сведений для группы ролей «Администраторы получателей».
| Скопировать код |
|
|---|---|
Get-RoleGroup "Recipient Administrators" | Format-List |
|
Дополнительные сведения о конвейерной передаче и командлете Format-List см. в разделах Работа с выходными данными команды и Передача по конвейеру.
ПРИМЕР 3
В данном примере показано получение списка групп ролей, видимых ближайшему к пользователю контроллеру домена.
| Скопировать код |
|
|---|---|
Get-RoleGroup -ReadFromDomainController |
|
ПРИМЕР 4
В данном примере показано получение списка всех связанных групп ролей, а также идентификатора безопасности (SID) Служба каталогов Active Directory внешних универсальных групп безопасности (USG), которые связаны с каждым из них. Идентификаторы безопасности затем могут быть использованы для поиска универсальных групп безопасности, поэтому их члены можно изменять.
| Скопировать код |
|
|---|---|
Get-RoleGroup -Filter { RoleGroupType -Eq "Linked" } | Format-Table Name, LinkedGroup
|
|