Set-AddressRewriteEntry

Этот командлет доступен или действует только на пограничных транспортных серверах в локальной среде Exchange.

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

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-AddressRewriteEntry
   [-Identity] <AddressRewriteEntryIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExceptionList <MultiValuedProperty>]
   [-ExternalAddress <String>]
   [-InternalAddress <String>]
   [-Name <String>]
   [-OutboundOnly <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Описание

На пограничных транспортных серверах для запуска этого командлета необходимо быть членом группы локальных администраторов.

Примеры

Пример 1

Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com

В этом примере для существующей записи переопределения адреса с именем "Address rewrite entry for contoso.com" изменяются следующие параметры.

Исходные адреса электронной почты, зависящие от записи переопределения адреса, заменяются на адреса домена northwindtraders.com.

Изменяется значение "Name" записи "Address rewrite entry for northwindtraders.com".

Пример 2

Set-AddressRewriteEntry "Address rewrite entry for all contoso.com email addresses" -OutboundOnly $true

В этом примере изменяется существующая запись переопределения адреса с именем "Address entry for all contoso.com email addresses" с входящей и исходящей почты на только исходящую. Необходимо настроить прокси-адрес, который совпадает с перезаписанным адресом электронной почты для всех затронутых получателей.

Параметры

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExceptionList

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalAddress

Параметр ExternalAddress задает необходимые конечные адреса электронной почты. Если параметр InternalAddress указывает один адрес электронной почты (chris@contoso.com), параметр ExternalAddress также должен указать один адрес электронной почты (support@contoso.com). Если параметр InternalAddress задает один домен (contoso.com) или домен и все поддомены (*.contoso.com), то параметр ExternalAddress должен указывать отдельный домен (fabrikam.com).

С параметром ExternalAddress не допускается использование подстановочного знака (*).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

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

Type:AddressRewriteEntryIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalAddress

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

  • Один адрес электронной почты: david@contoso.com
  • Один домен: contoso.com или sales.contoso.com
  • Домен и все поддомены: *.contoso.com
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-OutboundOnly

Параметр OutboundOnly включает или отключает переопределение адресов только для исходящей почты. Для этого параметра допускаются значения $true и $false. Значение $true показывает, что переопределение адресов выполняется только для исходящей почты. Значение $false показывает, что переопределение адресов выполняется как для исходящей, так и входящей почты (переопределенные адреса электронной почты изменяются обратно на исходные адреса электронной почты во входящей почте). Значение по умолчанию — $false.

Для этого параметра необходимо задать значение $true, если параметр InternalAddress содержит подстановочный знак для переопределения адресов в домене и всех поддоменах (*.contoso.com).

Кроме того, при настройке переопределения адресов только для исходящей почты необходимо настроить переопределенный адрес электронной почты в качестве прокси-адреса для затронутых получателей. Например, если laura@sales.contoso.com перезапись laura@contoso.comв , адрес laura@contoso.com прокси-сервера должен быть настроен в почтовом ящике Лоры. Это обеспечивает правильную доставку ответов и входящих сообщений.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.