Set-TransportAgent
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2007-07-27
Microsoft Exchange Server 2007 組織で、エッジ トランスポート サーバーの役割またはハブ トランスポート サーバーの役割がインストールされているコンピュータでトランスポート エージェントを変更するには、Set‑TransportAgent コマンドレットを使用します。
構文
Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]
解説
Set-TransportAgent コマンドレットは、エッジ トランスポート サーバーまたはハブ トランスポート サーバーでトランスポート エージェントを変更するために使用します。
Set-TransportAgent コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange サーバー管理者の役割および対象サーバーのローカルの Administrators グループ
エッジ トランスポート サーバーの役割がインストールされているコンピュータで Set-TransportAgent コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。
Exchange 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
Identity |
必須 |
System.String |
このパラメータを使用して、変更するトランスポート エージェントの表示名を指定します。名前の長さは、64 文字以下にする必要があります。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するためには、コマンドの処理内容を確認する必要があります。Confirm パラメータに値を指定する必要はありません。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。DomainController パラメータは、エッジ トランスポート サーバーの役割を実行するコンピュータではサポートされません。エッジ トランスポート サーバーの役割は、ローカルの ADAM インスタンスに対してのみ読み取りと書き込みを行います。 |
Priority |
省略可能 |
System.Nullable |
このパラメータを使用して、トランスポート エージェントの優先度を指定します。トランスポート エージェントの優先度は、トランスポート エージェントが電子メール メッセージを処理する順序を制御します。優先度は、0 からトランスポート エージェントの最大数の間の値である必要があります。既定の動作では、新しいトランスポート エージェントが優先度の一覧の最後に追加されます。最も 0 に近い優先度を持つトランスポート エージェントが、最初に電子メール メッセージを処理します。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータに値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
例外
| 例外 | 説明 |
|---|---|
|
例
次の例は、架空のウイルス対策エージェントの優先度を変更する方法を示しています。
Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。