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

Последнее изменение раздела: 2011-04-24

С помощью командлета New-DynamicDistributionGroup можно создать динамическую группу рассылки.

Синтаксис

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <None | MailboxUsers | Resources | MailContacts | MailGroups | MailUsers | AllRecipients> [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-SendModerationNotifications <Never | Internal | Always>] [-WhatIf [<SwitchParameter>]]
New-DynamicDistributionGroup -Name <String> -RecipientFilter <String> [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-SendModerationNotifications <Never | Internal | Always>] [-WhatIf [<SwitchParameter>]]

Параметры

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

IncludedRecipients

Обязательный

Microsoft.Exchange.Data.Directory.Recipient.WellKnownRecipientType

Параметр IncludedRecipients отфильтровывает типы получателей, которые используются для образования динамической группы рассылки. Параметр IncludedRecipients нельзя использовать, если задан параметр RecipientFilter. Можно использовать следующие значения:

  • AllRecipients

  • MailboxUsers

  • Resources

  • MailContacts

  • MailGroups

  • MailUsers

  • None

Значение AllRecipients может использоваться только отдельно. Если параметр IncludedRecipients имеет несколько значений, разделенных запятыми, применяется логический оператор OR.

Name

Обязательный

System.String

Параметром Name указывается имя динамической группы рассылки. Если параметр DisplayName не указан, то значение параметра Name используется и для параметра DisplayName .

Значение параметра Name не может превышать 64 символа.

Если значения параметров Name и DisplayName различны:

  • Параметр Name указывает имя динамической группы рассылки в оснастке «Пользователи и компьютеры Служба каталогов Active Directory», а также в поле Имя группы консоли управления Exchange.

  • Параметр DisplayName определяет имя динамической группы рассылки в консоли управления Exchange и в глобальном списке адресов Exchange.

RecipientFilter

Обязательный

System.String

Параметр RecipientFilter отфильтровывает получателей электронной почты, используемых для создания динамической группы рассылки. Параметр RecipientFilter нельзя использовать, если указан любой из следующих параметров:

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalCustomAttribute N (где N – число от 1 до 15)

  • ConditionalDepartment

  • ConditionalStateOrProvince

Параметр RecipientFilter использует синтаксис OPath для отправки запросов в Служба каталогов Active Directory и фильтрации получателей.

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

Alias

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

System.String

Параметром Alias указывается псевдоним динамической группы рассылки. Параметр Alias используется для создания основного SMTP-адреса электронной почты этой динамической группы рассылки. Значение параметра Alias не может содержать пробелов. Если параметр Alias не указан, в качестве значения параметра Name используется значение параметра Alias, при этом знаки пробела в значении параметра Name преобразуются в символы подчеркивания (_).

ArbitrationMailbox

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

ConditionalCompany

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

Microsoft.Exchange.Data.MultiValuedProperty

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

Если параметр ConditionalCompany имеет несколько значений, разделенных запятыми, применяется логический оператор OR.

ConditionalCustomAttribute1

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute10

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute11

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute12

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute13

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute14

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute15

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute2

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute3

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute4

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute5

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute6

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute7

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute8

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCustomAttribute9

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

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalDepartment отфильтровывает пользователей почтовых ящиков и почтовые контакты, которые используются для формирования динамической группы рассылки. Параметр ConditionalDepartment нельзя использовать, если задан параметр RecipientFilter.

Если параметр ConditionalDepartment имеет несколько значений, разделенных запятыми, применяется логический оператор OR.

ConditionalStateOrProvince

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalStateOrProvince отфильтровывает пользователей почтовых ящиков и почтовые контакты, которые используются для формирования динамической группы рассылки. Параметр ConditionalStateOrProvince нельзя использовать, если задан параметр RecipientFilter.

Если параметр ConditionalStateOrProvince имеет несколько значений, разделенных запятыми, применяется логический оператор OR.

Confirm

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

System.Management.Automation.SwitchParameter

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

ExternalDirectoryObjectId

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

System.String

ModeratedBy

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

Microsoft.Exchange.Data.MultiValuedProperty

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

Этот параметр обязателен, если для параметра ModerationEnabled установлено значение $true. Если оставить данный параметр пустым, и если существует пользователь, который уже указан в качестве администратора для данной динамической группы рассылки, параметр ModeratedBy автоматически задается равным параметру ManagedBy этой динамической группы рассылки. В противном случае возвращается ошибка.

ModerationEnabled

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

System.Boolean

Параметр ModerationEnabled указывает, включено ли модерирование для динамической группы рассылки. Чтобы включить контроль, установите для этого параметра значение $true. Чтобы отключить контроль, установите для этого параметра значение $false.

Значение по умолчанию равно $false.

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

OverrideRecipientQuotas

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

System.Management.Automation.SwitchParameter

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

Параметр PrimarySmtpAddress указывает основной SMTP-адрес возврата электронной почты для динамической группы рассылки. Этот параметр имеет смысл использовать только в том случае, если динамическая группа рассылки содержит несколько SMTP-адресов электронной почты.

RecipientContainer

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр RecipientContainer позволяет применить фильтр к получателям, которые используются для создания динамической группы рассылки, на основе их расположения в Служба каталогов Active Directory. В качестве значения параметра RecipientContainer может использоваться каноническое имя подразделения или домена. Если значение параметра RecipientContainer не указано, по умолчанию для фильтра поиска используется расположение динамической группы рассылки в Служба каталогов Active Directory. Это расположение задается параметром OrganizationalUnit.

SendModerationNotifications

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

Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags

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

  • Always

  • Internal

  • Never

Если требуется отправлять уведомления о состоянии всем отправителям, присвойте этому параметру значение Always.

Чтобы отправлять уведомления только отправителям внутри организации, установите для этого параметра значение Internal.

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

Примечание.
Отправители всегда получают уведомление в случае, если сообщение отклонено модераторами, независимо от значения этого параметра.

Значение по умолчанию равно Never.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Динамическая группа рассылки запрашивает почтовые объекты Служба каталогов Active Directory и организует участие в группе на основе результатов данного запроса. Участие в группе определяется заново каждый раз при отправке в эту группу сообщения электронной почты. Фильтры запроса, предусмотренные в Microsoft Exchange, ограничены сочетаниями следующих параметров:

  • ConditionalCompany

  • ConditionalCustomAttribute N (где N – число от 1 до 15)

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Кроме того, параметр RecipientFilter позволяет создать любой пользовательский запрос.

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

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

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

Ошибки

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

 

 

Исключения

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

  

 

Примеры

ПРИМЕР 1

В этом примере в контейнере «Users» домена contoso.com создается динамическая группа рассылки «Marketing Group» . Динамическая группа рассылки «Marketing Group» включает в себя всех пользователей почтовых ящиков или почтовые контакты в домене contoso.com, у которых в поле Отдел содержатся строки «Marketing» или «Sales».

Скопировать код 
New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "contoso.com"

ПРИМЕР 2

В этом примере в контейнере «Users» домена contoso.com с помощью параметра RecipientFilter создается динамическая группа рассылки «Pacific Northwest» . Динамическая группа рассылки «Pacific Northwest» включает в себя всех пользователей почтовых ящиков в домене сontoso.com, у которых поле Область, край содержит значение «Washington» или «Oregon».

Скопировать код 
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "contoso.com"