New-AddressRewriteEntry (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-07

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

構文

new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>]

解説

Microsoft Exchange Server 2007 では、アドレス書き換えにより、Exchange 2007 組織との間で送受信されるメッセージの送信者および受信者のアドレスを変更できます。エッジ トランスポート サーバーの役割がインストールされているコンピュータの受信コネクタと送信コネクタでアドレス書き換えエージェントを構成します。

エッジ トランスポート サーバーの役割がインストールされているコンピュータで New-AddressRewriteEntry コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。

パラメータ

パラメータ 必須かどうか 種類 説明

ExternalAddress

必須

System.String

このパラメータは、内部電子メール アドレスまたはドメイン名を書き換える際に使用する外部電子メール アドレスまたはドメイン名を指定します。InternalAddress に電子メール アドレスを指定する場合は、ExternalAddress に指定する値も電子メール アドレスである必要があります。InternalAddress にドメイン名またはワイルドカード文字を含むドメイン名を指定する場合は、ExternalAddress にドメイン名を指定する必要があります。アドレスまたはドメイン名は、次の 2 つの形式で入力できます。

  • 電子メール アドレス   指定したアドレスを使用して 1 つの内部電子メール アドレスを書き換えます。たとえば、「david@northwindtraders.com」と入力します。
  • ドメイン名   指定した外部ドメイン名を使用して、InternalAddress に含まれるすべての内部電子メール アドレスを書き換えます。たとえば、「northwindtraders.com」と入力します。
note注 :
アスタリスク文字は、ExternalAddress パラメータでは使用できません。

InternalAddress

必須

System.String

このパラメータは、書き換えの対象となる内部電子メール アドレスまたはドメイン名を指定します。アドレスまたはドメイン名は、次の 3 つの形式で入力できます。

  • 単一の電子メール アドレス   指定したアドレスのみを書き換えます。たとえば、「david@contoso.com」と入力します。
  • ドメイン名   指定したドメイン名と関連付けられているすべての電子メール アドレスを書き換えます。たとえば、「contoso.com」と入力します。
  • アスタリスクを含むドメイン名   指定したドメイン名と関連付けられているすべての電子メール アドレスとすべてのサブドメインを書き換えます。たとえば、「*.contoso.com」と入力します。

Name

必須

System.String

このパラメータを使用すると、管理者はこのアドレス書き換えエントリの一意の名前を変更できます。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。DomainController パラメータは、エッジ トランスポート サーバーではサポートされません。エッジ トランスポート サーバーの役割は、ローカルの ADAM インスタンスにのみ書き込みを行います。

ExceptionList

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、InternalAddress パラメータに複数のドメイン名を指定する値が含まれている場合に、書き換えを禁止するドメイン名を指定します。ExceptionList パラメータで複数のドメイン名を指定する場合は、ドメイン名をコンマで区切ります。

OutboundOnly

省略可能

System.Boolean

このパラメータには、電子メール メッセージが Exchange 2007 組織から送信される場合にのみ電子メール アドレスを書き換えるか、それともメッセージがどちらの方向に送信される場合でもアドレスを書き換えるかを指定します。このパラメータに指定できる値は $true または $false の 2 つです。既定値は $false です。

note注 :
InternalAddress に指定した値にワイルドカード文字が含まれている場合、このパラメータを $false に設定することはできません。

TemplateInstance

省略可能

System.Management.Automation.PSObject

このパラメータに既存のオブジェクトを指定すると、コマンドはそのオブジェクトの構成を使用してローカル サーバーまたはターゲット サーバーにオブジェクトの同一コピーを作成します。

入力の種類

戻り値の種類

エラー

エラー 説明

 

例外

例外 説明

 

例

次の例は、3 つの異なるシナリオを示しています。

  • 1 つの電子メール アドレスを書き換えます。双方向の電子メール メッセージが書き換えられます。
  • contoso.com ドメインのすべての電子メール アドレスを書き換えます。双方向の電子メール メッセージが書き換えられます。
  • contoso.com ドメイン、および research.contoso.com と corp.contoso.com を除くすべてのサブドメインの電子メール アドレスすべてを書き換えます。送信電子メール メッセージのみが書き換えられます。
New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。