Remove-CsWebServiceConfiguration
上次修改主題的時間： 2012-03-26
移除一或多個 Web 服務 組態設定的集合。
語法
Remove-CsWebServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
許多 Microsoft Lync Server 2010 元件為 Web 元件：這些元件使用 Web 服務或網頁來執行工作。例如，使用者利用 Web 服務搜尋通訊錄的新連絡人，或使用群組擴充來檢視通訊群組的個別成員。同樣地，從電話撥入式會議到 Microsoft Lync Server 2010 控制台 等元件都是使用網頁作為 Lync Server 2010 和使用者之間的介面。
CsWebServiceConfiguration 指令程式可讓系統管理員管理整個組織的 Web 服務 組態設定。其中包括管理群組擴充、憑證設定以及允許的驗證方法。因為您可以在全域、網站和服務範圍 (僅限 Web Services 服務) 設定不同設定，您可以針對不同使用者和不同位置來自訂 Web 服務功能。
如果您在網站或服務範圍建立自訂 Web 服務 組態設定，則稍後可以使用 Remove-CsWebServiceConfiguration 指令程式來移除這些設定。請注意，您也可以針對 Web 服務 設定的通用集合執行 Remove-CsWebServiceConfiguration。不過，在該情況下將不會移除通用集合；那是因為 Lync Server 不允許您移除通用設定，而是將通用集合中的所有屬性還原為其預設值。例如，假設您已將 MaxGroupSizeToExpand 值變更為 500。因為此屬性的預設值為 100，因此，「移除」通用集合會將 MaxGroupSizeToExpand 屬性的值重設為 100。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsWebServiceConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsWebServiceConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
要移除之 Web 服務 組態設定的唯一識別碼。若要移除在網站範圍設定的設定，請使用類似如下的語法：-Identity "site:Redmond"。若要移除在服務範圍設定的設定，請使用類似如下的語法：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 您也可以針對通用集合執行 Remove-CsWebServiceConfiguration。不過，在該情況下將不會移除通用集合；而是將該集合中的所有屬性重設為其預設值。若要重設通用集合，請使用此語法：-Identity global。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 物件。Remove-CsWebServiceConfiguration 接受管線傳送的 Web 服務設定物件輸入。
傳回類型
無。而 Remove-CsWebServiceConfiguration 會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsWebServiceConfiguration -Identity site:Redmond
以上的命令會移除 Redmond 網站的 Web 服務 組態設定。
-------------------------- 範例 2 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Remove-CsWebServiceConfiguration
在範例 2 中，會移除在網站範圍設定的所有 Web 服務 設定。若要執行此工作，此命令會先呼叫 Get-CsWebServiceConfiguration 並搭配 Filter 參數；篩選值 "site:*" 會確保只傳回 Identity 開頭為字元為 "site:" 的設定。。接著，這個篩選過的集合會傳送到 Remove-CsWebServiceConfiguration，以刪除集合中的每個項目。
-------------------------- 範例 3 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration
範例 3 所示的命令會刪除已停用群組擴充的所有 Web 服務 組態設定。若要這樣做，此命令會先呼叫沒有任何參數的 Get-CsWebServiceConfiguration，以傳回組織中使用之所有 Web 服務 組態設定的集合。接著，此集合會傳送到 Where-Object 指令程式，只選取 EnableGroupExpansion 屬性等於 False 的設定。接著，這個篩選過的集合會傳送到 Remove-CsWebServiceConfiguration，以刪除集合中的每個項目。