Set-AddressRewriteEntry

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

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

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

Синтаксис

Default (По умолчанию)

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

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Подтвердить без значения приводит к приостановке, которая заставляет подтвердить команду перед продолжением.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainController

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Тип:Fqdn
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExceptionList

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExternalAddress

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Тип:AddressRewriteEntryIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-InternalAddress

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

  • Один адрес электронной почты: david@contoso.com
  • Один домен: contoso.com или sales.contoso.com
  • Домен и все поддомены: *.contoso.com

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OutboundOnly

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

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

Свойства параметров

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.