New-DynamicDistributionGroup

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2009-05-12

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

Синтаксис

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> [-Alias <String>] [-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>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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

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

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

  • ConditionalCompany

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

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

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

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

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

Параметры

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

IncludedRecipients

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

System.Nullable

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

Допустимыми значениями параметра IncludedRecipients являются: AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users и 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 для запросов в Active Directory и фильтрации получателей используется синтаксис OPath.

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

Alias

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

System.String

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

ConditionalCompany

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

Microsoft.Exchange.Data.MultiValuedProperty

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

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

ConditionalCustomAttribute1

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute10

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute11

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute12

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute13

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute14

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute15

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute2

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute3

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute4

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute5

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute6

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute7

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute8

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute9

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

Microsoft.Exchange.Data.MultiValuedProperty

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

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

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

RecipientContainer

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

TemplateInstance

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

System.Management.Automation.PSObject

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

UseRusServer

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

System.String

noteПримечание.
Этот параметр доступен только в сервере Exchange Server 2007 с пакетом обновления 2 (SP2).

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

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

  

 

Пример

Следующие примеры фрагментов кода иллюстрируют использование команды 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"