Remove-CsProxyConfiguration
上次修改主題的時間： 2012-03-25
移除 Proxy 伺服器組態設定的現有集合。
語法
Remove-CsProxyConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 可讓您經由 Proxy 伺服器組態設定來管理 Proxy 伺服器。這些可同時在全域範圍和服務範圍上套用的設定 (雖然只針對 Edge Server 和登錄器服務)，可讓您控制能夠由用戶端端點使用的驗證通訊協定，以及是否在傳入和傳出的 Proxy 伺服器連線中使用壓縮。安裝 Lync Server 2010 時，會自動為您建立 Proxy 伺服器組態設定的通用集合。如上述，您還可以在服務範圍上建立其他集合。
任何您建立的新 Proxy 伺服器設定都可以在稍後使用 Remove-CsProxyConfiguration 指令程式移除。您也可以對通用集合執行 Remove-CsProxyConfiguration。但在此狀況下不會移除通用設定；因為 Lync Server 不容許您移除通用設定。而是將該通用集合中的所有屬性重設為預設值。例如，根據預設，Proxy 伺服器設定容許用戶端使用 Kerberos 通訊協定進行驗證。您可以變更通用設定以停用 Kerberos。不過，如果您對通用集合執行 Remove-CsProxyConfiguration，則上述的屬性 (UseKerberosForClientToProxyAuth) 將重設為其預設值，且 Kerberos 會再度啟用，作為驗證通訊協定之用。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsProxyConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsProxyConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除之 Proxy 伺服器組態設定的唯一識別碼，例如：-Identity "service:Registrar:atl-cs-001.litwareinc.com"。 也可以對通用設定執行 Remove-CsProxyConfiguration。但此狀況下不會移除設定。而是將該通用集合中的屬性全部重設為預設值。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 物件。Remove-CsProxyConfiguration 會接受 Proxy 設定物件的管線執行個體。
傳回類型
無。而 Remove-CsProxyConfiguration 會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 物件的現有執行個體。
範例
-------------------------- 範例 1 --------------------------
Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com
範例 1 所示的命令會刪除具有 Identity service:EdgeServer:atl-edge-litwareinc.com 的 Proxy 組態設定。
-------------------------- 範例 2 --------------------------
Get-CsProxyConfiguration -Filter "service:*" | Remove-CsProxyConfiguration
在範例 2 中，會刪除在服務範圍套用的所有 Proxy 組態設定。若要完成此工作，命令會先呼叫 Get-CsProxyConfiguration 和 Filter 參數。篩選值 "service:*" 確保只有 Identity 以字串值 "service:" 為開頭的 Proxy 設定。開頭的設定。此篩選的集合接著被傳送到 Remove-CsProxyConfiguration，此指令程式會刪除集合中的每個項目。
-------------------------- 範例 3 --------------------------
Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration
上述命令會刪除將所有用戶端視為遠端用戶端的任何 Proxy 組態設定。為了執行這項作業，會先呼叫 Get-CsProxyConfiguration 且不搭配任何參數，以傳回目前正在使用的所有 Proxy 伺服器組態設定集合。接著將此集合傳送給 Where-Object 指令程式，這樣只會選取 TreatAllClientsAsRemote 屬性等於 True 的設定。此 Proxy 組態設定的子集便會被傳送到 Remove-CsProxyConfiguration，該指令程式會移除集合中的所有設定。