Командлет 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. Адреса и имена доменов могут вводиться в следующих двух форматах:
|
||
InternalAddress |
Обязательный |
System.String |
Этот параметр указывает адрес внутренней электронной почты или имя домена, которые должны быть перезаписаны. Адреса и имена доменов могут вводиться в следующих трех форматах:
|
||
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, или адреса должны
перезаписываться, когда сообщения отсылаются в обоих направлениях.
Два возможных значения для этого параметра:
|
||
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 |