New-AddressRewriteEntry

このコマンドレットは、オンプレミスの 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

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