Set-RecipientFilterConfig

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2009-05-18

エッジ トランスポート サーバーの役割またはハブ トランスポート サーバーの役割がインストールされているコンピュータで受信者フィルタ エージェントを有効にして構成するには、Set-RecipientFilterConfig コマンドレットを使用します。

構文

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

解説

Set-RecipientFilterConfig コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。

  • Exchange サーバー管理者の役割および対象サーバーのローカルの Administrators グループ

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

アクセス許可、役割の委任、および Microsoft Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

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

BlockedRecipients

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

BlockedRecipients Enabled パラメータに対する有効な入力は、1 つ以上の SMTP アドレスです。この BlockedRecipients パラメータには、異なる SMTP アドレスを 800 個まで入力できます。

BlockListEnabled

省略可能

System.Boolean

BlockListEnabled Enabled パラメータに対する有効な入力は、$true または $false です。既定の設定は $false です。BlockListEnabled パラメータを $true に設定すると、受信者フィルタ エージェントは、BlockedRecipients パラメータに列挙されている受信者に送信されるメッセージをブロックします。

Confirm

省略可能

System.Management.Automation.SwitchParameter

Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するためには、コマンドの処理内容を確認する必要があります。Confirm パラメータに値を指定する必要はありません。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

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

Enabled

省略可能

System.Boolean

Enabled パラメータに対する有効な入力は、$true または $false です。既定の設定は $true です。Enabled パラメータが $true に設定されている場合、Set-RecipientFilterConfig コマンドレットを実行しているコンピュータで受信者フィルタ エージェントが有効になります。

ExternalMailEnabled

省略可能

System.Boolean

ExternalMailEnabled パラメータに対する有効な入力は、$true または $false です。既定の設定は $true です。ExternalMailEnabled パラメータが $true に設定されている場合、認証されていない接続からのメッセージはすべて、処理のために受信者フィルタ エージェントを経由して渡されます。

Instance

省略可能

Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig

Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。

InternalMailEnabled

省略可能

System.Boolean

InternalMailEnabled パラメータに対する有効な入力は、$true または $false です。既定の設定は $false です。InternalMailEnabled パラメータが $true に設定されている場合、エンタープライズ内の権限のあるドメインに属する認証済みの送信者ドメインからのメッセージはすべて、処理のために受信者フィルタ エージェントを経由して渡されます。

RecipientValidationEnabled

省略可能

System.Boolean

RecipientValidationEnabled Enabled パラメータに対する有効な入力は、$true または $false です。既定の設定は $false です。RecipientValidationEnabled パラメータを $true に設定すると、受信者フィルタ エージェントは、組織内に存在しない受信者を含むメッセージをブロックします。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータに値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

次のコード例は、2 つの Set-RecipientFilterConfig コマンドを示しています。

最初のコード例は、受信者の検証が有効になるように受信者フィルタの構成を変更する方法を示しています。

2 番目のコード例は、ブロックする受信者の一覧を有効にして、その一覧に受信者を追加する方法を示しています。

BlockedRecipients パラメータには複数の値を指定します。BlockedRecipients パラメータに値を渡すと、既存の値が新規の値で置き換えられます。複数値プロパティで値の追加または削除を行う方法の詳細については、「複数値プロパティの変更」を参照してください。

Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com

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