Командлет New-AddressList используется для создания списка адресов и его применения к получателям.

Синтаксис

New-AddressList -Name <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>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Name

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

System.String

Параметр Name задает желаемое имя для нового списка адресов. Имя не должно содержать более 64 знаков и не должно включать знаков возврата каретки и обратной косой черты (\).

ConditionalCompany

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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 является фильтром, определяющим отдел. Все получатели с атрибутом отдела, совпадающим со значением, введенным для данного параметра, будут включены в список адресов. В качестве списка можно использовать несколько значений, разделенных запятыми. Этот параметр не допускается использовать, если используется параметр RecipientFilter. Следует использовать или параметр RecipientFilter, или один из следующих параметров фильтра:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalStateOrProvince

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Confirm

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

System.Management.Automation.SwitchParameter

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

Container

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

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Параметр Container задает идентификатор родительского списка адресов, в котором будет создан новый список адресов. Если родительский список адресов не указан, список адресов будет создан в корне «Все списки адресов».

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы задать полное доменное имя контроллера домена, который записывает эти изменения конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.

IncludedRecipients

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

System.Nullable

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

  • None

  • UserMail

  • Resources

  • MailGroups

  • MailContacts

  • AllRecipients

Этот параметр не допускается использовать, если используется параметр RecipientFilter. Следует использовать или параметр RecipientFilter, или один из следующих параметров фильтра:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

RecipientFilter

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

System.String

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Следует использовать или этот параметр, или один из приведенных выше параметров фильтра.

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

TemplateInstance

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

System.Management.Automation.PSObject

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

UseRusServer

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

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

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

  • роль администратора организации Exchange.

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В первом примере демонстрируется создание нового списка адресов с названием MyAddressList. Этот список адресов включает получателей, которые являются пользователями почтовых ящиков и у которых параметру StateOrProvince присвоено значение Washington (Вашингтон) или Oregon (Орегон).

Во втором примере показано, как создать новый список адресов «MyAddressList2», включающий почтовые ящики, для которых параметру ConditionalStateOrProvince присвоено значение Washington (Вашингтон).

Копировать код 
New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers