Set-EmailAddressPolicy
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2009-05-12
Командлет 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 <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-EmailAddressPolicy [-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 <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Подробное описание
Командлет Set-EmailAddressPolicy позволяет администраторам задавать атрибуты Active Directory для отдельной политики адресов электронной почты. Однако командлет Set-EmailAddressPolicy не применяет изменений к политике адресов электронной почты. Для применения сделанных изменений воспользуйтесь командлетом Update-EmailAddressPolicy после командлета Set-EmailAddressPolicy.
Для выполнения командлета Set-EmailAddressPolicy используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Дополнительные сведения о командлете Update-EmailAddressPolicy см. в разделе Update-EmailAddressPolicy.
Параметры
| Параметр | Обязательный | Тип | Описание | ||
|---|---|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter |
С помощью параметра Identity можно задать GUID, различающееся имя или имя политики адресов электронной почты, которые представляют определенную политику адресов электронной почты. Можно также включить путь в формате «путь\политика_адресов_электронной_почты». Можно опустить метку параметра Identity, оставив только имя политики адресов электронной почты или идентификатор GUID. |
||
ConditionalCompany |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCompany указывает компанию для политики адресов электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute1 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute1 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute10 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute10 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute11 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute11 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute12 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute12 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute13 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute13 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute14 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute14 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute15 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute15 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute2 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute2 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute3 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute3 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute4 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute4 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute5 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute5 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute6 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute6 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute7 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute7 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute8 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute8 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalCustomAttribute9 |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCustomAttribute9 указывает настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalDepartment |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalDepartment указывает отдел для политики адресов электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
ConditionalStateOrProvince |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalStateOrProvince указывает область или регион для политики адресов электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется. |
||
DisabledEmailAddressTemplates |
Необязательный |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
Параметр DisabledEmailAddressTemplates определяет отключенные прокси-адреса, входящие в политику адресов электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя (FQDN) контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController. |
||
EnabledEmailAddressTemplates |
Необязательный |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
Параметр EnabledEmailAddressTemplates определяет включенные прокси-адреса, входящие в политику адресов электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. |
||
EnabledPrimarySMTPAddressTemplate |
Необязательный |
System.String |
Параметр EnabledPrimarySMTPAddressTemplate указывает включенные прокси-адреса, входящие в политику адресов электронной почты. Можно использовать несколько значений в виде списка, разделенного запятыми. |
||
ForceUpgrade |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ForceUpgrade запрещает вывод следующего подтверждения: «Чтобы сохранить изменения, внесенные в объект, необходимо обновить объект до текущей версии Exchange. После обновления управление этим объектом с помощью предыдущей версии диспетчера Exchange будет невозможно. Продолжить обновление и сохранить объект?». Этот подтверждение выводится при обновлении политики адресов электронной почты, созданной в Microsoft Exchange Server 2003 или Exchange 2000 Server. Политикой адресов электронной почты Exchange 2003 или Exchange 2000 нельзя управлять с помощью консоли управления Exchange до тех пор, пока версия объекта не будет обновлена, а фильтр получателей не будет изменен с помощью параметров RecipientFilter или IncludedRecipients . |
||
IncludedRecipients |
Необязательный |
System.Nullable |
Параметр IncludedRecipients обеспечивает фильтрацию типов получателей, которые используются для построения глобального списка адресов. Допустимые значения параметра IncludedRecipients: AllRecipients, MailboxUsers, Resources, Contacts и MailGroups. Значение AllRecipients может использоваться только самим параметром. Если несколько значений параметра IncludedRecipients разделены запятыми, применяется логический оператор OR. Этот параметр необходимо использовать, если используется любой из параметров Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
||
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy |
Параметр Instance позволяет передать в обрабатываемую команду весь объект. Он обычно используется в сценариях, где целый объект должен быть отправлен команде. |
||
Name |
Необязательный |
System.String |
Параметр Name указывает новое имя политики адресов электронной почты. |
||
Priority |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority |
Параметр Priority задает более высокий текущий приоритет, чем приоритет, заданный в качестве аргумента для этого параметра. |
||
RecipientFilter |
Необязательный |
System.String |
Параметр RecipientFilter фильтрует получателей, входящих в конкретную политику адресов электронной почты. Параметр RecipientFilter нельзя использовать, если указан любой из следующих параметров:
Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter. |
||
UseRusServer |
Необязательный |
System.String |
Параметр UseRusServer указывает на необходимость использования определенного сервера почтовых ящиков, на котором выполняется служба списка адресов, для получения и установки атрибутов почтового ящика и пользователя Active Directory. Служба списка адресов является компонентом службы системного помощника Exchange. С ее помощью создаются и поддерживаются характерные для Exchange значения атрибутов в Active Directory. Служба списка адресов позволяет обновлять объекты получателя в домене с использованием определенных сведений, таких как членство в списке адресов и адреса электронной почты. |
||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
.gif "note")
Примечание.Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
Исключения
| Исключения | Описание |
|---|---|
Пример
Следующий код содержит пример команды Set-EmailAddressPolicy, с помощью которой имя политики адресов электронной почты EMAIL_ADDRESS_POLICY01 меняется на имя EMAILADDRESSPOLICY02.
Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02