Для запроса существующих групп используется командлет Get-Group.

Синтаксис

Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

Параметр Обязательный Тип Описание

Anr

Необязательный

System.String

Параметр Anr указывает, что аргумент будет разрешен при помощи разрешения неоднозначных имен (ANR).

Credential

Необязательный

System.Management.Automation.PSCredential

Параметр Credential указывает учетную запись, используемую для считывания службы каталогов Active Directory. Это особенно полезно при указании глобального каталога. Пароль должен запрашиваться безопасным образом.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController.

Filter

Необязательный

System.String

Параметр Filter указывает фильтр, который необходимо использовать для фильтрации получателей.

Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter.

Identity

Необязательный

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Параметр Identity группы рассылки может иметь одну из следующих форм:

  • идентификатор GUID

  • Различающееся имя (DN)

  • Имя участника-пользователя (UPN)

  • имя LegacyExchangeDN

  • Домен\Имя учетной записи

  • Псевдоним

IgnoreDefaultScope

Необязательный

System.Management.Automation.SwitchParameter

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

  • Использовать параметр DomainController нельзя. Команда автоматически будет использовать подходящий сервер глобального каталога.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

  • Параметры OrganizationalUnit и Identity нельзя использовать вместе.

  • Параметр Credential использовать нельзя.

OrganizationalUnit

Необязательный

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit ограничивает результаты контейнером определенного подразделения.

ReadFromDomainController

Необязательный

System.Management.Automation.SwitchParameter

Параметр ReadFromDomainController указывает на то, что информация о пользователе считывается с контроллера домена в домене пользователя. Если область получателей установлена таким образом, что в нее входят все получатели в лесу, и данный параметр не используется, возможно считывание информации о пользователе из глобального каталога с устаревшими сведениями. Если данный параметр используется, для получения сведений может потребоваться несколько операций чтения.

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

RecipientTypeDetails

Необязательный

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей в Microsoft Exchange Server 2007 разделены на типы и подтипы получателей. Каждый тип получателей содержит все общие свойства всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Поскольку существует несколько типов почтовых ящиков, каждый тип почтового ящика определяется параметром RecipientTypeDetails. Например, для почтового ящика конференц-зала для параметра RecipientTypeDetails установлено значение ConferenceRoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox.

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

  • MailEnabledContact

  • MailEnabledForestContact

  • NonUniversalGroup

  • UniversalDistributionGroup

  • UniversalSecurityGroup

ResultSize

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает максимальное количество членов, которые будут возвращены.

SortBy

Необязательный

System.String

Атрибут SortBy используется для сортировки результатов.

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

Командлет Get-Group возвращает все существующие группы, соответствующие указанным параметрам фильтрации, в Microsoft Windows.

Для выполнения командлета Get-Group используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора Exchange с правами на просмотр.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

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

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

Ошибки

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

Исключения

Исключения Описание

Пример

Следующий код является примером команды Get-Group. В этом примере команда Get-Group используется без параметров для возвращения всех групп в Active Directory.

Копировать код
Get-Group