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

Синтаксис

Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DynamicDistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DynamicDistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-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.

Identity

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

Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter

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

  • GUID

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

  • Основное имя пользователя

  • LegacyExchangeDN

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

  • Alias

  • Первичный SMTP-адрес

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

ManagedBy

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

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

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

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

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

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

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

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

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

Ошибки

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

 

Исключения

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

Пример

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

Копировать код
Get-DynamicDistributionGroup -Identity "Marketing" | Format-List