Set-AddressRewriteEntry

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange のエッジトランスポートサーバーでのみ使用可能または有効になります。

Set-AddressRewriteEntry コマンドレットを使って、既存のアドレス書き換えエントリを変更します。このエントリは、エッジトランスポートサーバーを通じて組織との間で送受信されるメッセージの送信者と受信者の電子メールアドレスを書き換えるときに使用されます。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

エッジトランスポートサーバーで、このコマンドレットを実行するには、ローカルの Administrators グループのメンバーである必要があります。

例

例 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

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 からのデータの読み取りまたは 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 パラメーターで 1 つの電子メールアドレス (chris@contoso.com) を指定する場合は、ExternalAddress パラメーターも 1 つの電子メールアドレス (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
1 つのドメイン: 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 です。

InternalAddress パラメーターに、ドメイン内のアドレスとすべてのサブドメイン (*.contoso.com) を書き換えるワイルドカード文字が含まれている場合は、このパラメーターを $true に設定する必要があります。

また、送信専用アドレス書き換えを構成する場合には、書き換えられたメールアドレスを、影響を受ける受信者のプロキシアドレスとして構成する必要があります。たとえば、がにlaura@contoso.com書き換えられた場合laura@sales.contoso.com、プロキシアドレスlaura@contoso.comは Laura のメールボックスで構成する必要があります。このようにすると、返信および受信メッセージを適切に配信できます。

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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。