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 パラメータに対する有効な入力は、 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するためには、コマンドの処理内容を確認する必要があります。Confirm パラメータに値を指定する必要はありません。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。DomainController パラメータは、エッジ トランスポート サーバーの役割がインストールされているコンピュータではサポートされません。エッジ トランスポート サーバーの役割は、ローカルの ADAM インスタンスにのみ書き込みを行います。 |
Enabled |
省略可能 |
System.Boolean |
Enabled パラメータに対する有効な入力は、 |
ExternalMailEnabled |
省略可能 |
System.Boolean |
ExternalMailEnabled パラメータに対する有効な入力は、 |
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig |
Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。 |
InternalMailEnabled |
省略可能 |
System.Boolean |
InternalMailEnabled パラメータに対する有効な入力は、 |
RecipientValidationEnabled |
省略可能 |
System.Boolean |
RecipientValidationEnabled Enabled パラメータに対する有効な入力は、 |
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 を参照してください。