Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

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

Синтаксис

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

Параметры

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

Anr

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

System.String

Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

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

System.Management.Automation.PSCredential

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Filter

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

System.String

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

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

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

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

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

  • Имя LegacyExchangeDN

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

  • Псевдоним

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter
  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.

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

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

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

ManagedBy

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

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

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

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

    Ниже перечислены доступные значения.

    • ArbitrationMailbox

    • ConferenceRoomMailbox

    • Contact

    • DiscoveryMailbox

    • DynamicDistributionGroup

    • EquipmentMailbox

    • ExternalManagedContact

    • ExternalManagedDistributionGroup

    • LegacyMailbox

    • LinkedMailbox

    • MailboxPlan

    • MailContact

    • MailForestContact

    • MailNonUniversalGroup

    • MailUniversalDistributionGroup

    • MailUniversalSecurityGroup

    • MailUser

    • PublicFolder

    • RoleGroup

    • RoomList

    • RoomMailbox

    • SharedMailbox

    • SystemAttendantMailbox

    • SystemMailbox

    • User

    • UserMailbox

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

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

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

Запись «Группы рассылки» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

  

Исключения

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

  

Примеры

ПРИМЕР 1

В этом примере возвращается группа Marketing Reports и объект передается в команду Format-List для отображения сведений о группе рассылки.

Скопировать код 
Get-DistributionGroup -Identity "Marketing Reports" | Format-List

ПРИМЕР 2

В этом примере возвращаются все группы рассылки, имя которых начинается со строки «Marketing», и объект передается в команду Format-Table для отображения имен групп рассылки, а также пользователей, которые ими управляют.

Скопировать код 
Get-DistributionGroup -Anr marketing | Format-Table Name, ManagedBy