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

Синтаксис

new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Параметры

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

ExternalAddress

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

System.String

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

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

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

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

InternalAddress

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

System.String

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

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

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

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

Name

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

System.String

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

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

ExceptionList

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

Microsoft.Exchange.Data.MultiValuedProperty

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

OutboundOnly

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

System.Boolean

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

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

TemplateInstance

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

System.Management.Automation.PSObject

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

В следующих примерах показано три разных сценария:

  • Перезапись одиночного адреса электронной почты. Перезаписываются электронные сообщения в обоих направлениях.

  • Перезапись всех адресов электронной почты в домене contoso.com. Перезаписываются электронные сообщения в обоих направлениях.

  • Перезапись всех адресов электронной почты для домена contoso.com и всех поддоменов за исключением research.contoso.com и corp.contoso.com. Перезаписываются только исходящие электронные сообщения.

Копировать код
New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true -ExceptionList research.contoso.com,corp.contoso.com