New-AddressRewriteEntry

リファレンス

モジュール:: ExchangePowerShell

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

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

エッジトランスポートサーバーを介して組織との間で送受信されるメッセージで、送信者および受信者の電子メールアドレスを書き換えるアドレス書き換えエントリを作成するには、New-AddressRewriteEntry コマンドレットを使用します。

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

構文

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

説明

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

例

例 1

New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com

次の使用例は、送信メールでに電子メールアドレスを書き換えるアドレス書き換えエントリをdavid@northwindtraders.com作成しますdavid@contoso.com。 OutboundOnly パラメーターは $true に設定されていないため、に david@northwindtraders.com 送信された受信メールはに david@contoso.com書き戻されます。

例 2

New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com email addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com

この例では、送信メールで contoso.com ドメイン内のすべての電子メールアドレスを northwindtraders.com に書き換えるアドレス書き換えエントリを作成します。 OutboundOnly パラメーターは $true に設定されていないため、northwindtraders.com 受信者に送られた受信メールは contoso.com に書き換えられます。

例 3

New-AddressRewriteEntry -Name "Address rewrite entry for contoso.com and all subdomain email addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -ExceptionList research.contoso.com,corp.contoso.com -OutboundOnly $true

この例では、送信メールで contoso.com ドメイン内のすべての電子メールアドレスを northwindtraders.com に書き換えるアドレス書き換えエントリを作成します。ただし、research.contoso.com および corp.contoso.com の電子メールアドレスは書き換えられません。このアドレス書き換えエントリはドメインとすべてのサブドメイン (*.contoso.com) に影響するため、アドレス書き換えは送信メールのみで行われます。

パラメーター

-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 パラメーターにドメイン内のアドレスとすべてのサブドメイン (*.contoso.com) を書き換えるワイルドカード文字が含まれている場合に書き換えてはいけないメールアドレスドメインを指定します。 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:	True
Accept pipeline input:	False
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:	True
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:	1
Default value:	None
Required:	True
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

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

次の方法で共有