Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-24

Командлет Set-EmailAddressPolicy используется для установки атрибутов Служба каталогов Active Directory для политики адресов электронной почты.

Синтаксис


Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-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>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <None \| MailboxUsers \| Resources \| MailContacts \| MailGroups \| MailUsers \| AllRecipients>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-WhatIf [<SwitchParameter>]]

Set-EmailAddressPolicy -Identity
<EmailAddressPolicyIdParameter> [-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>]]
[-DisabledEmailAddressTemplates
<ProxyAddressTemplateCollection>] [-DomainController
<Fqdn>] [-EnabledEmailAddressTemplates
<ProxyAddressTemplateCollection>]
[-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade
<SwitchParameter>] [-IncludedRecipients <None |
MailboxUsers | Resources | MailContacts | MailGroups | MailUsers |
AllRecipients>] [-Name <String>] [-Priority
<EmailAddressPolicyPriority>] [-RecipientContainer
<OrganizationalUnitIdParameter>] [-RecipientFilter
<String>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр	Обязательный	Тип	Описание
Identity	Обязательный	Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter	С помощью параметра Identity можно задать GUID, различающееся имя или имя политики адресов электронной почты, которые представляют конкретную политику адресов электронной почты. Путь также можно указать в формате Path\EmailAddressPolicy. Метку параметра можно опустить, чтобы указать только имя политики адреса электронной почты или GUID.
ConditionalCompany	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметр ConditionalCompany указывает компанию для политики адреса электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр невозможно применять, если используется параметр RecipientFilter.
ConditionalCustomAttribute1	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute10	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute11	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute12	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute13	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute14	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute15	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute2	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute3	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute4	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute5	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute6	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute7	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute8	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalCustomAttribute9	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение `Marketing`, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение `Marketing`. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.
ConditionalDepartment	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметр ConditionalDepartment указывает отдел для политики адреса электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. При использовании параметра Conditional необходимо также использовать параметрIncludedRecipients. Этот параметр невозможно применять, если используется параметр RecipientFilter.
ConditionalStateOrProvince	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметр ConditionalStateOrProvince указывает край или область для политики адреса электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр невозможно применять, если используется параметр RecipientFilter.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.
DisabledEmailAddressTemplates	Необязательный	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	Параметр DisabledEmailAddressTemplates указывает отключенные адреса прокси-серверов, содержащихся в политике адреса электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.
EnabledEmailAddressTemplates	Необязательный	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	Параметр EnabledEmailAddressTemplates указывает включенные адреса прокси-серверов, содержащихся в политике адреса электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми.
EnabledPrimarySMTPAddressTemplate	Необязательный	System.String	Параметр EnabledPrimarySMTPAddressTemplate указывает включенные адреса прокси-серверов, содержащихся в политике адреса электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми.
ForceUpgrade	Необязательный	System.Management.Automation.SwitchParameter	Параметр ForceUpgrade определяет необходимость запрещения следующего подтверждения: «Чтобы сохранить изменения, внесенные в объект, необходимо обновить объект до текущей версии Exchange. После обновления управление этим объектом с помощью предыдущей версии диспетчера Exchange будет невозможно. Продолжить обновление и сохранить объект?». Это подтверждение выводится при обновлении политики адресов электронной почты, созданной в версии Microsoft Exchange Server 2003. Управление политикой адреса электронной почты Exchange 2003 невозможно из консоли управления Exchange до момента обновления версии объекта и изменения фильтра получателей с помощью параметров RecipientFilter или IncludedRecipients .
IncludedRecipients	Необязательный	Microsoft.Exchange.Data.Directory.Recipient.WellKnownRecipientType	Параметр IncludedRecipients обеспечивает фильтрацию типов получателей, которые используются для построения глобального списка адресов. Допустимые значения параметра IncludedRecipients: AllRecipients, MailboxUsers, Resources, Contacts и MailGroups. Значение AllRecipients может использоваться только самим параметром. Если параметр IncludedRecipients имеет несколько значений, разделенных запятыми, применяется логический оператор OR. Этот параметр необходимо использовать, если используется любой из параметров Conditional. Этот параметр невозможно применять, если используется параметр RecipientFilter.
Name	Необязательный	System.String	Параметр Name указывает новое имя политики адресов электронной почты.
Priority	Необязательный	Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority	Параметр Priority указывает, что текущий приоритет выше, чем приоритет, заданный в качестве аргумента для этого параметра.
RecipientContainer	Необязательный	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Параметр RecipientContainer фильтрует получателей, использованных для создания политики адресов электронной почты, по их расположению в доменных службах Служба каталогов Active Directory (AD DS). В качестве значения параметра RecipientContainer может использоваться каноническое имя подразделения (OU) или домена. Если значение параметра RecipientContainer не указано, по умолчанию для фильтра поиска используется расположение динамической группы рассылки в службах AD DS.
RecipientFilter	Необязательный	System.String	Параметр RecipientFilter фильтрует получателей, включенных в определенную политику адреса электронной почты. Параметр RecipientFilter нельзя использовать, если указан любой из следующих параметров: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.

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

Командлет Set-EmailAddressPolicy не применяет изменения к политике адреса электронной почты. Для применения сделанных изменений воспользуйтесь командлетом Update-EmailAddressPolicy после командлета Set-EmailAddressPolicy.

Дополнительные сведения о командлете Update-EmailAddressPolicy см. в разделе Update-EmailAddressPolicy.

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Политики адресов электронной почты» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

Исключения

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

Примеры

ПРИМЕР 1

В этом примере имя политики адресов электронной почты изменяется с EMAIL_ADDRESS_POLICY01 на EMAILADDRESSPOLICY02.

	Скопировать код
Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAILADDRESSPOLICY02

ПРИМЕР 2

В данном примере выполняется добавление получателей из Техаса в политику адресов электронной почты South East Offices, содержащую получателей в штатах Джорджия, Алабама и Луизиана.

	Скопировать код
Set-EmailAddressPolicy -Identity "South East Offices" -ConditionalStateorProvince "Georgia","Alabama","Louisiana","Texas"

Примечание.
Несмотря на то что политика уже применена к получателям в Джорджии, Алабаме и Луизиане, ее необходимо включить в параметр, так как он перезаписывает значения. Присоединение новых значений к существующим не происходит.