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 指令程式即可重新啟用該應用程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsServerApplication Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsServerApplication }
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除之伺服器應用程式的唯一識別碼。伺服器應用程式 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 中，伺服器應用程式的 Identity 為 service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor 會遭到移除。因為 Identity 必須是唯一的，所以此命令永遠只會刪除一個應用程式。
-------------------------- 範例 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 服務的伺服器應用程式。為了執行這項作業，則要使用 Get-CsServerApplication 搭配 Filter 參數；篩選值 "service:EdgeServer:atl-cs-001.litwareinc.com/*" 會傳回 Identity 開頭為 "service:EdgeServer:atl-cs-001.litwareinc.com/" 字元的所有應用程式。接著該集合會傳送到 Remove-CsServerApplication，這會將每個應用程式從 EdgeServer:atl-cs-001.litwareinc.com 中刪除。