Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет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 <None | MailboxUsers | Resources |
MailContacts | MailGroups | MailUsers | AllRecipients>]
[-Organization <OrganizationIdParameter>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf [<SwitchParameter>]]
|
New-AddressList -Name <String> [-Confirm
[<SwitchParameter>]] [-Container
<AddressListIdParameter>] [-DisplayName <String>]
[-DomainController <Fqdn>] [-Organization
<OrganizationIdParameter>] [-RecipientContainer
<OrganizationalUnitIdParameter>] [-RecipientFilter
<String>] [-WhatIf [<SwitchParameter>]]
|
Параметры
| Параметр | Обязательность | Тип | Описание |
|---|---|---|---|
|
Name |
Обязательный |
System.String |
Параметр Name указывает имя нового списка адресов. Имя не должно содержать более 64 символов и не должно включать в себя символы возврата каретки и обратной косой черты (\). |
|
ConditionalCompany |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCompany является фильтром, определяющим компанию. Все получатели с атрибутом компании, который соответствует значению, введенному для этого параметра, включены в список адресов. Можно использовать несколько значений в виде списка, разделенного запятыми. Этот параметр невозможно применять, если используется параметр RecipientFilter. Необходимо использовать параметр RecipientFilter или один из следующих параметров фильтра:
|
|
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 является фильтром, определяющим отдел. Все получатели с атрибутом отдела, который соответствует значению, введенному для этого параметра, включены в список адресов. Можно использовать несколько значений в виде списка, разделенного запятыми. Этот параметр невозможно применять, если используется параметр RecipientFilter. Необходимо использовать параметр RecipientFilter или один из следующих параметров фильтра:
|
|
ConditionalStateOrProvince |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalStateOrProvince является фильтром, определяющим область или регион. Все получатели с атрибутом ConditionalStateOrProvince, который соответствует значению, введенному для этого параметра, включены в список адресов. Можно использовать несколько значений в виде списка, разделенного запятыми. Этот параметр невозможно применять, если используется параметр RecipientFilter. Необходимо использовать параметр RecipientFilter или один из следующих параметров фильтра:
|
|
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|
|
Container |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
Параметр Container указывает идентификатор родительского списка адресов, в котором будет создан новый список адресов. Если родительский список адресов не указан, список адресов будет создан в корне каталога «Все списки адресов». |
|
DisplayName |
Необязательный |
System.String |
Параметр DisplayName указывает краткое имя списка адресов. Если краткое имя не указано, имя списка адресов будет также и кратким именем. |
|
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|
|
IncludedRecipients |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.WellKnownRecipientType |
Параметр IncludedRecipients является фильтром, определяющим тип получателя, включаемого в список адресов. Можно использовать один или несколько следующих типов:
Этот параметр невозможно применять, если используется параметр RecipientFilter. Необходимо использовать параметр RecipientFilter или один из следующих параметров фильтра:
|
|
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
|
|
RecipientContainer |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр RecipientContainer позволяет применить фильтр к получателям, которые используются для создания динамической группы рассылки, на основе их расположения в Служба каталогов Active Directory. В качестве значения параметра RecipientContainer может использоваться каноническое имя подразделения или домена. Если значение параметра RecipientContainer не указано, по умолчанию для фильтра поиска используется расположение динамической группы рассылки в Служба каталогов Active Directory. |
|
RecipientFilter |
Необязательный |
System.String |
Параметр RecipientFilter определяет фильтр для получателей, включаемых в список адресов. Этот параметр невозможно применять, если используется любой из следующих параметров фильтра.
Необходимо использовать этот параметр или один из приведенных выше параметров фильтра. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter. |
|
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Подробное описание
Запись «Списки адресов» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
|
Примеры
ПРИМЕР 1
В этом примере создается список адресов MyAddressList. Этот список адресов включает получателей, которые являются пользователями почтовых ящиков и у которых параметру StateOrProvince присвоено значение «Московская обл.» или «Приморский кр.».
 Скопировать код |
|
|---|---|
New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
|
|
ПРИМЕР 2
В этом примере выполняется создание списка адресов MyAddressList2, в состав которого входят почтовые ящики, для параметраConditionalStateOrProvince которых установлено значение «Московская обл.».
| Скопировать код |
|
|---|---|
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers |
|