Get-RoleGroup

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

Командлет Get-RoleGroup используется для получения списка групп ролей управления.

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

Синтаксис

Get-RoleGroup
   [[-Identity] <RoleGroupIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [-ShowPartnerLinked]
   [-SortBy <String>]
   [<CommonParameters>]

Описание

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

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

Примеры

Пример 1

Get-RoleGroup

В данном примере показано получение списка групп ролей.

Пример 2

Get-RoleGroup "Recipient Administrators" | Format-List

В данном примере показано получение сведений для группы ролей "Администраторы получателей".

Пример 3

Get-RoleGroup -ReadFromDomainController

В данном примере показано получение списка групп ролей, видимых ближайшему к пользователю контроллеру домена.

Пример 4

Get-RoleGroup -Filter "RoleGroupType -eq 'Linked'" | Format-Table Name, LinkedGroup

В этом примере извлекается список всех связанных групп ролей и идентификатор безопасности Active Directory внешних универсальных групп безопасности (USG), связанных с каждой из них. Идентификаторы безопасности затем могут быть использованы для поиска универсальных групп безопасности, поэтому их члены можно изменять.

Параметры

-DomainController

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

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Filter

Параметр Filter использует синтаксис OPath для фильтрации результатов по указанным свойствам и значениям. В критериях поиска используется синтаксис. "Property -ComparisonOperator 'Value'"

  • Заключив весь фильтр OPath в двойные кавычка ". Если фильтр содержит системные значения (например, , или), используйте $true $false $null одиночные кавычка ' . Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать скобки { }, но только если фильтр не содержит переменные.
  • Свойство является фильтруемым свойством.
  • ComparisonOperator — это оператор сравнения OPath (например, для равного и -eq -like сравнения строк). Дополнительные сведения об операторах сравнения см.в about_Comparison_Operators.
  • Значение — это значение свойства, для поиска. Заключив текстовые значения и переменные в одиночные кавычках ( 'Value' или '$Variable' ). Если значение переменной содержит одиночная кавычка, необходимо определить (избежать) одиночные кавычка, чтобы правильно развернуть переменную. Например, вместо этого '$User' используйте '$($User -Replace "'","''")' . Не заключяйте в них все эти значения (например, 500 $true , , или $false $null ).

Вы можете сцепить несколько критериев поиска, используя логические операторы -and и -or . Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Дополнительные сведения о фильтрах OPath в Exchange см. в дополнительных сведениях о синтаксисах OPATH.

Можно фильтровать по следующим свойствам:

  • LinkedGroup
  • ManagedBy
  • Members
  • Имя
  • RoleGroupType (доступные значения Standard и Linked)
  • DisplayName
Type:String
Position:Named
Default value:None
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 Center, Exchange Online Protection
-Identity

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

Если параметр Identity не определен, будут возвращены все группы ролей.

Type:RoleGroupIdParameter
Position:1
Default value:None
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 Center, Exchange Online Protection
-ReadFromDomainController

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

Переключатель ReadFromDomainController указывает, что сведения будут считываться из контроллера домена в домене пользователя. Если выполнить команду Set-AdServerSettings -ViewEntireForest $true для включения всех объектов в лесу и переключатель ReadFromDomainController не используется, сведения могут быть считаны из глобального каталога с устаревшими данными. Если переключатель ReadFromDomainController используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения. Значение этого параметра указывать необязательно.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:Unlimited
Position:Named
Default value:None
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 Center, Exchange Online Protection
-ShowPartnerLinked

Этот параметр доступен или работает только в облачной службе.

Параметр ShowPartnerLinked указывает, следует ли возвращать встроенные группы ролей типа PartnerRoleGroup. Группы ролей этого типа используются в облачных службах для того, чтобы позволить партнерам-поставщикам услуг управлять клиентскими организациями. Эти группы ролей нельзя изменять, поэтому по умолчанию они не отображаются.

Type:SwitchParameter
Position:Named
Default value:None
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 Center, Exchange Online Protection
-SortBy

Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.

Если представление по умолчанию не включает свойство, по которое вы сортировать, можно к ней приметься. | Format-Table -Auto Property1,Property2,...PropertyX для создания нового представления, которое содержит все свойства, которые необходимо просмотреть. Поддерживаются под wildcards ( * ) в именах свойств.

Можно выполнять сортировку по следующим свойствам:

  • Name
  • DisplayName
Type:String
Position:Named
Default value:None
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 Center, Exchange Online Protection

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

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

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

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