Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-24
Командлет Get-DynamicDistributionGroup используется для получения настроек существующей динамической группы рассылки.
Синтаксис
Get-DynamicDistributionGroup [-Identity
<DynamicGroupIdParameter>] [-Credential <PSCredential>]
[-DomainController <Fqdn>] [-Filter <String>]
[-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>]
|
Get-DynamicDistributionGroup [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter
<String>] [-IgnoreDefaultScope <SwitchParameter>]
[-ManagedBy <GeneralRecipientIdParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>]
|
Get-DynamicDistributionGroup [-Anr <String>]
[-Credential <PSCredential>] [-DomainController <Fqdn>]
[-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>]
|
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Anr |
Необязательный |
System.String |
Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:
|
||
Credential |
Необязательный |
System.Management.Automation.PSCredential |
Этот параметр Credential указывает имя пользователя или пароль для получения доступа к Служба каталогов Active Directory. Для этого параметра требуется создание и передача объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Дополнительные сведения см. в разделе Get-Credential. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Параметр DomainController указывает имя FQDN контроллера домена, получающего данные из Служба каталогов Active Directory. Параметр DomainController не поддерживается ролью пограничного транспортного сервера. Роль пограничного транспортного сервера выполняет чтение только из экземпляра служб облегченного доступа к каталогам Служба каталогов Active Directory. |
||
Filter |
Необязательный |
System.String |
Параметр Filter указывает фильтр OPath, используемый для фильтрации получателей. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter. |
||
Identity |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter |
Параметр Identity задает динамическую группу рассылки. Можно использовать одно из следующих значений:
|
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения.
|
||
ManagedBy |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
Параметр ManagedBy указывает имя пользователя почтового ящика, группы или контакта с включенной поддержкой почты, которое отображается на вкладке Управляется объекта Служба каталогов Active Directory. Для этого параметра доступны следующие значения:
|
||
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support. Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации. |
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр OrganizationalUnit ограничивает результаты конкретным контейнером подразделения. |
||
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ReadFromDomainController указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если установлена область получателей для включения всех получателей в лесу и этот параметр не используется, сведения о пользователе могут быть прочитаны из глобального каталога с устаревшими сведениями. Если этот параметр используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения.
|
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное число возвращаемых объектов получателя. |
||
SortBy |
Необязательный |
System.String |
Параметр SortBy используется для сортировки результатов. |
Подробное описание
Группы рассылки можно использовать для создания списков рассылки электронной почты и групп безопасности, позволяющих назначить разрешения для общих ресурсов. Группы рассылки могут использоваться только с приложениями электронной почты (такими как Microsoft Exchange) для отправки сообщений электронной почты определенному числу пользователей. Командлет Get-DynamicDistributionGroup можно использовать для возвращения параметров существующей группе рассылки в службе каталогов Служба каталогов Active Directory.
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Динамические группы рассылки» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
Примеры
ПРИМЕР 1
В этом примере возвращается динамическая группа рассылки Marketing, и объект передается в команду Format-List для отображения сведений об этой группе.
Скопировать код | |
---|---|
Get-DynamicDistributionGroup -Identity "Marketing" | Format-List |
ПРИМЕР 2
В этом примере возвращаются все динамические группы рассылки, содержащие строку "Research", и объект передается по конвейеру в команду Format-Table для отображения имен этих групп и пользователей, которые ими управляют.
Скопировать код | |
---|---|
Get-DynamicDistributionGroup -Anr *research* | Format-Table Name, ManagedBy |