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

Синтаксис

Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-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

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

Filter

Дополнительно

System.String

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

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

Идентификатор

Дополнительно

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

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

  • GUID;

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

  • LegacyExchangeDN

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

  • псевдоним.

ManagedBy

Дополнительно

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

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.

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

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

ResultSize

Дополнительно

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize показывает максимальное количество возвращаемых объектов получателей.

SortBy

Дополнительно

System.String

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

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

Группы рассылки можно использовать для создания списков рассылки электронной почты и групп безопасности, позволяющих назначить разрешения для общих ресурсов. Группы рассылки могут использоваться только с приложениями электронной почты (такими как Exchange) для отправки сообщений электронной почты определенному числу пользователей. Командлет Get-DistributionGroup можно использовать для опроса существующих групп рассылки.

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

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

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

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

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

Ошибки

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

  

Исключения

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

  

Пример

Следующий код содержит пример команды Get-DistributionGroup. В этом примере команда Get-DistributionGroup извлекает группу Distribution Group1 и транспортирует объект для команды Format-List, чтобы отобразить сведения о группе рассылки.

Копировать код 
Get-DistributionGroup -Identity "Distribution Group1" | Format-List