Remove-CsServerApplication
トピックの最終更新日: 2012-03-27
既存のサーバー アプリケーションを削除します。サーバー アプリケーションは、Microsoft Lync Server 2010 によってホストされるアプリケーションです。
構文
Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
サーバー アプリケーションとは、Lync Server 2010 で実行される個々のプログラムのことです。Remove-CsServerApplication コマンドレットを使用することにより、管理者は、Lync Server の一部として実行されている任意のアプリケーションを削除できます。サーバー アプリケーションの削除は、アプリケーションのアンインストールと同じではないことに注意してください。Remove-CsServerApplication を実行すると、アプリケーションは Lync Server で実行されなくなります。ただし、ソフトウェア自体はアンインストールされず、そのアプリケーションは New-CsServerApplication コマンドレットを実行することによって再度有効にできます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsServerApplication コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsServerApplication }
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
Xds Identity |
削除するサーバー アプリケーションの一意の識別子です。サーバー アプリケーションの Identity は、アプリケーションをホストしているサービスとアプリケーション名から構成されます。たとえば、QoEAgent という名前のサーバー アプリケーションは、次のような Identity を持ちます。service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application オブジェクト。Remove-CsServerApplication は、サーバー アプリケーション オブジェクトのパイプライン処理されたインスタンスを受け入れます。
戻り値の種類
Remove-CsServerApplication は、Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application オブジェクトの既存のインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"
例 1 では、ID が service: EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor のサーバー アプリケーションを削除します。ID は一意である必要があるため、このコマンドによって複数のアプリケーションが削除されることはありません。
-------------------------- 例 2 ------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $False} | Remove-CsServerApplication
例 2 では、重要でないサーバー アプリケーションをすべて削除しています。このタスクを実行するため、コマンドではまず、Get-CsServerApplication を呼び出して組織で現在使用中のすべてのサーバー アプリケーションのコレクションを戻します。次に、このコレクションを Where-Object にパイプ処理して、Critical プロパティが False と等しいアプリケーションをすべて選択します。次に、このフィルター処理したコレクションを Remove-CsServerApplication にパイプ処理し、コレクション内の各項目を削除します。
-------------------------- 例 3 ------------------------
Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication
上記のコマンドでは、サービス EdgeServer:atl-cs-001.litwareinc.com が使用するように構成されているサーバー アプリケーションをすべて削除しています。これを実行するため、Filter パラメーターを指定して Get-CsServerApplication を使用します。フィルター値 "service:EdgeServer:atl-cs-001.litwareinc.com/*" により、ID が文字列 "service:EdgeServer:atl-cs-001.litwareinc.com/" で始まるすべてのアプリケーションが戻されます。さらに、このコレクションを Remove-CsServerApplication にパイプ処理して、EdgeServer:atl-cs-001.litwareinc.com から各アプリケーションを削除します。