Set-AddressRewriteEntry

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-08-28

Командлет Set-AddressRewriteEntry используется для настройки существующей записи переопределения адреса, переопределяющей адреса электронной почты отправителя и получателя во входящих и исходящих сообщениях электронной почты организации.

Синтаксис

set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

set-addressrewriteentry [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

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

В Microsoft Exchange Server 2007 функция переопределения адресов позволяет изменять адреса отправителей и получателей во входящих и исходящих сообщениях организации Exchange 2007. Агенты переопределения адреса настраиваются в получающем или отправляющем соединителе на компьютере с установленной ролью пограничного транспортного сервера.

Для запуска командлета Set-AddressRewriteEntry на компьютере с установленной ролью пограничного транспортного сервера необходимо выполнить вход с учетной записью, имеющей разрешения локальной группы «Администраторы».

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

Параметры

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

Identity

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

Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter

Этот параметр определяет настраиваемую запись переопределения адреса. Параметр Identity принимает в качестве значения идентификатор GUID или уникальное имя переопределения адреса.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

ExceptionList

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет доменные имена, которые не должны перезаписываться, если параметр InternalAddress содержит значение с несколькими доменными именами. При указании нескольких доменных имен, включенных в параметр ExceptionList, в качестве разделителя можно использовать запятые. Дополнительные сведения о добавлении и удалении значений многозначных свойств см. в разделе Изменение многозначных свойств.

ExternalAddress

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

System.String

Этот параметр позволяет администратору изменить внешний адрес электронной почты или доменное имя, используемые при переопределении внутреннего адреса электронной почты или доменного имени. Если в параметре InternalAddress задан адрес электронной почты, то значение, заданное в параметре ExternalAddress, также должно быть адресом электронной почты. Если в параметре InternalAddress указано доменное имя или доменное имя с подстановочным знаком, то в параметре ExternalAddress должно быть задано доменное имя. Для ввода адресов и доменных имен могут применяться следующие форматы:

  • Адрес электронной почты   Переопределение одного внутреннего адреса электронной почты с помощью указанного адреса. Например, david@northwindtraders.com.

  • Доменное имя   Переопределение всех внутренних адресов электронной почты, включенных в параметр InternalAddress, с использованием указанного внешнего доменного имени. Например, northwindtraders.com.

noteПримечание.
Знак "звездочка" не может использоваться с параметром ExternalAddress.

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry

Параметр Instance позволяет передать команде целый объект для обработки. В основном он используется, когда команде передается целый объект.

InternalAddress

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

System.String

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

  • Один адрес электронной почты   Переопределение только указанного адреса. Например, david@contoso.com.

  • Доменное имя   Переопределение всех адресов электронной почты, связанных с указанным доменным именем. Например, contoso.com.

  • Доменное имя со звездочкой   Переопределение всех адресов электронной почты, связанных с указанным доменным именем, и всех поддоменов. Например, *.contoso.com.

Name

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

System.String

Этот параметр позволяет администратору настроить уникальное имя данной записи переопределения адреса.

OutboundOnly

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

System.Boolean

С помощью этого параметра администратор может определить, когда выполняется переопределение адресов электронной почты: только при отправке сообщений электронной почты из организации Exchange Server 2007 или при передаче сообщений в обоих направлениях. Этот параметр может иметь одно из двух значений: $true или $false. По умолчанию используется значение $false.

noteПримечание.
Для данного параметра не может быть задано значение $false, если значение, указанное в параметре InternalAddress, содержит подстановочный знак.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

Далее приведены примеры настройки существующей записи переопределения адреса. В первом примере задается запись внутреннего имени домена. Описательное имя этой записи также изменяется в соответствии с новым именем домена.

Во втором примере для параметра OutboundOnly задается значение $true. Это действие сообщает агенту переопределения адресов о необходимости переопределения адресов только для исходящих сообщений электронной почты в организации Exchange 2007.

importantВажно!
Для внутренних отправителей, затрагиваемых записью изменения адреса с параметром OutboundOnly, для которого задано значение $true, должен быть настроен адрес прокси-сервера, соответствующий переопределяемому адресу электронной почты. 
Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com 
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true