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

Синтаксис

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

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

Параметры

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

Имя

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

System.String

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

ConditionalCompany

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalStateOrProvince

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

Microsoft.Exchange.Data.MultiValuedProperty

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Контейнер

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

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

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

DisplayName

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

System.String

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

IncludedRecipients

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

System.Nullable

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

  • None (нет)

  • UserMail

  • Ресурсы

  • MailGroups

  • MailContacts

  • AllRecipients

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

RecipientFilter

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

System.String

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

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

TemplateInstance

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

System.Management.Automation.PSObject

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

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

Для выполнения командлета 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