Set-AddressRewriteEntry
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2007-08-28
電子メール組織との間で送受信する電子メール メッセージの送信者および受信者の電子メール アドレスを書き換える、既存のアドレス書き換えエントリを変更するには、Set‑AddressRewriteEntry コマンドレットを使用します。
構文
set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]
set-addressrewriteentry [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]
解説
Microsoft Exchange Server 2007 では、アドレス書き換えにより、Exchange 2007 組織との間で送受信されるメッセージの送信者および受信者のアドレスを変更できます。エッジ トランスポート サーバーの役割がインストールされているコンピュータの受信コネクタと送信コネクタでアドレス書き換えエージェントを構成します。
エッジ トランスポート サーバーの役割がインストールされているコンピュータで Set-AddressRewriteEntry コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。
Exchange 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須かどうか | 種類 | 説明 | ||
---|---|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter |
このパラメータは、変更するアドレス書き換えエントリを指定します。Identity パラメータには、GUID または一意のアドレス書き換え名を指定できます。 |
||
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
||
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。DomainController パラメータは、エッジ トランスポート サーバーではサポートされません。エッジ トランスポート サーバーの役割は、ローカルの ADAM インスタンスにのみ書き込みを行います。 |
||
ExceptionList |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータは、InternalAddress パラメータに複数のドメイン名を指定する値が含まれている場合に、書き換えを禁止するドメイン名を指定します。ExceptionList パラメータで複数のドメイン名を指定する場合は、ドメイン名をコンマで区切ります。複数値プロパティの値を追加または削除する方法の詳細については、「複数値プロパティの変更」を参照してください。 |
||
ExternalAddress |
省略可能 |
System.String |
このパラメータを使用すると、管理者は、内部電子メール アドレスやドメイン名を書き換える際に使用する外部電子メール アドレスやドメイン名を変更することができます。InternalAddress に電子メール アドレスを指定する場合は、ExternalAddress に指定する値も電子メール アドレスである必要があります。InternalAddress にドメイン名またはワイルドカード文字を使ったドメイン名を指定する場合は、ExternalAddress にドメイン名を指定する必要があります。アドレスまたはドメイン名は、次の 2 つの形式で入力できます。
|
||
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry |
Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。 |
||
InternalAddress |
省略可能 |
System.String |
このパラメータを使用すると、管理者は書き換えの対象となる内部電子メール アドレスやドメイン名を変更できます。アドレスまたはドメイン名は、次の 3 つの形式で入力できます。
|
||
Name |
省略可能 |
System.String |
このパラメータを使用すると、管理者はこのアドレス書き換えエントリの一意の名前を変更できます。 |
||
OutboundOnly |
省略可能 |
System.Boolean |
このパラメータを使用すると、管理者は、電子メール メッセージが Exchange Server 2007 組織から送信される場合にのみ電子メール アドレスを書き換えるように変更したり、メッセージがいずれの方向に送信される場合もアドレスを書き換えるように指定したりすることができます。このパラメータに指定できる値は
|
||
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
例外
例外 | 説明 |
---|---|
|
例
次の例は、既存のアドレス書き換えエントリを変更する方法を示しています。最初の例では、書き込む内部ドメイン名を設定しています。このエントリの内容を示す名前も、書き換えられた新しいドメイン名を反映するように変更されます。
2 番目の例では、OutboundOnly パラメータを $true
に設定しています。この操作により、アドレス書き換えエージェントに対して、Exchange 2007 組織から送信される電子メール メッセージのアドレスのみを書き換えるように指定します。
重要 : |
---|
OutboundOnly パラメータが $true に設定されたアドレス書き換えエントリの影響を受ける内部送信者は、書き換えられた電子メール アドレスに一致する構成済みのプロキシ アドレスを持っている必要があります。 |
Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。