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