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

Синтаксис

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]

New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]

Параметры

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

IncludedRecipients

Обязательность

System.Nullable

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

Допустимыми значениями параметра IncludedRecipients являются: AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users и None.

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

Имя

Обязательность

System.String

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

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

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

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

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

OrganizationalUnit

Обязательность

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

RecipientFilter

Обязательность

System.String

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

  • IncludedRecipients

  • ConditionalCompany

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

  • ConditionalDepartment

  • ConditionalStateOrProvince

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

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

псевдоним.

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

System.String

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

ConditionalCompany

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

Microsoft.Exchange.Data.MultiValuedProperty

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

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

ConditionalCustomAttribute1

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

System.String

Параметр ConditionalCustomAttribute1 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute10

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

System.String

Параметр ConditionalCustomAttribute10 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute11

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

System.String

Параметр ConditionalCustomAttribute11 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute12

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

System.String

Параметр ConditionalCustomAttribute12 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute13

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

System.String

Параметр ConditionalCustomAttribute13 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute14

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

System.String

Параметр ConditionalCustomAttribute14 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute15

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

System.String

Параметр ConditionalCustomAttribute15 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute2

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

System.String

Параметр ConditionalCustomAttribute2 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute3

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

System.String

Параметр ConditionalCustomAttribute3 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute4

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

System.String

Параметр ConditionalCustomAttribute4 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute5

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

System.String

Параметр ConditionalCustomAttribute5 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute6

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

System.String

Параметр ConditionalCustomAttribute6 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute7

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

System.String

Параметр ConditionalCustomAttribute7 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute8

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

System.String

Параметр ConditionalCustomAttribute8 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalCustomAttribute9

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

System.String

Параметр ConditionalCustomAttribute9 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений.

ConditionalDepartment

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

Microsoft.Exchange.Data.MultiValuedProperty

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

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

ConditionalStateOrProvince

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

Microsoft.Exchange.Data.MultiValuedProperty

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

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

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

С помощью параметра DomainController можно указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory.

RecipientContainer

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

TemplateInstance

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

System.Management.Automation.PSObject

Когда существующий объект предоставляется параметру TemplateInstance, командой используется конфигурация этого объекта для создания точной копии объекта.

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

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

  • ConditionalCompany

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

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

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

  • роль администратора получателей Exchange.

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

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

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

Ошибки

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

 

 

Исключения

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

  

 

Пример

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

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

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

Копировать код 
New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
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"