Remove-CsTrustedApplicationPool
トピックの最終更新日: 2012-03-25
信頼されたアプリケーションをホストするコンピューターを含むプールを削除します。
構文
Remove-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
Microsoft Lync Server 2010 展開内で信頼されたアプリケーションを実行しているコンピューターは、信頼されたアプリケーション専用の個別のプールに追加することをお勧めします。ただし、信頼されたアプリケーション コンピューターを、それ以外の目的でも使用される既存のプールに追加することができます。このコマンドレットは既存の信頼されたアプリケーション プールを削除します。ただし、Registrar 値を含まない信頼されたアプリケーション プールは削除することができません。信頼されたアプリケーション プールに Registrar が割り当てられていない場合、Set-CsTrustedApplicationPool コマンドレットを使って Registrar 値を 追加してから、プールを削除する必要があります。
プールを削除すると、そのプールに関連付けられているコンピューター、アプリケーション、アプリケーション エンドポイントもすべて削除されることに注意してください。
このコマンドレットを実行できるユーザー: 既定では、Remove-CsTrustedApplicationPool コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationPool"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
削除するプールの完全修飾ドメイン名 (FQDN) またはサービス ID です。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.Xds.DisplayExternalServer オブジェクトです。信頼されたアプリケーション プール オブジェクトのパイプライン処理による入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.Xds.DisplayExternalServer 型のオブジェクトを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com
この例は、FQDN が TrustPool.litwareinc.com であるプールを削除します。ID パラメーターを使用して、削除するプールの FQDN を指定します。ID は一意なため、このコマンドは最大で 1 つのプールを削除します。
-------------------------- 例 2 ------------------------
Get-CsTrustedApplicationPool | Where-Object {$_.PoolFqdn -match "trust*"} | Remove-CsTrustedApplicationPool
この例は、プールの FQDN が文字列 "trust" で始まるすべての信頼されたプールを削除します。コマンドの最初の部分では、Get-CsTrustedApplicationPool コマンドレットを呼び出し、Lync Server 2010 インフラストラクチャにあるすべての信頼されたアプリケーション プールのコレクションを取得します。次に、このコレクションを Where-Object コマンドレットへパイプ処理します。Where-Object コマンドレットにより、コレクション内の各項目の PoolFqdn がワイルドカード文字列 trust* に一致するかどうかを確認します。これは、PoolFqdn が文字列 trust で始まりその後に任意の文字 (または複数の文字) が続く、すべての信頼されたアプリケーション プールのコレクションとなります。最後に、このコレクションを Remove-CsTrustedApplicationPool コマンドレットへパイプ処理して、コレクション内のすべての項目を削除します。