Remove-CsClientVersionConfiguration
上次修改主題的時間： 2012-03-27
移除指定的用戶端版本組態設定集合。用戶端版本組態設定會決定 Microsoft Lync Server 2010 是否會檢查登入系統之每個用戶端應用程式的版本號碼。如果已啟用用戶端版本篩選，則該用戶端應用程式存取系統的能力將會根據適當用戶端版本原則中所設定的設定而定。
語法
Remove-CsClientVersionConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Lync Server 2010 讓系統管理員有相當大的彈性空間可指定使用者用來登入系統的用戶端軟體 (以及同樣重要的該軟體版本號碼)。例如，沒有任何技術上的原因非要使用者使用 Microsoft Lync 2010 登入 Lync Server 2010，也沒有任何一種技術可讓使用者無法使用 Microsoft Office Communicator 2007 R2 登入。
然而，也可能是一些非技術上的原因造成您不想要使用者使用 Office Communicator 2007 R2 登入。例如，Office Communicator 2007 R2 並不支援 Lync 2010 中所有的功能，因此使用 Office Communicator 2007 R2 登入的使用者其使用經驗，會與使用 Lync 2010 登入的使用者不同。這會對您的使用者造成一些困擾；也對服務台人員造成困擾，因為他們必須支援許多不同的用戶端應用程式。
如果您的組織有這個問題，則可以運用用戶端版本篩選功能來指定可使用哪些用戶端應用程式登入 Lync Server 2010。當您安裝 Lync Server 2010 時，會安裝並啟用一組通用的用戶端版本組態設定。除了通用設定之外，也會在站台範圍內套用用戶端版本組態設定。
任何您建立的站台設定日後皆可使用 Remove-CsClientVersionConfiguration 指令程式刪除。請注意，您也可以對通用設定執行 Remove-CsClientVersionConfiguration。在此狀況下不會移除通用設定，而是將通用屬性重設為預設值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsClientVersionConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsClientVersionConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除之用戶端版本組態設定集合的唯一識別碼。若要移除通用集合，請使用下列語法：-Identity global。(請記住，通用設定並不是真正的移除，而是將通用屬性全部重設回其預設值)。若要移除站台集合，請使用類似下列的語法：-Identity site:Redmond。請注意，在指定 Identity 時無法使用萬用字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 物件。Remove-CsClientVersionConfiguration 接受用戶端版本組態物件管線傳送的執行個體。
傳回類型
無。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsClientVersionConfiguration -Identity site:Redmond
範例 1 所示的命令會刪除 Identity 為 "site:Redmond" 的用戶端版本組態設定。
-------------------------- 範例 2 ------------------------
Get-CsClientVersionConfiguration -Filter site:* | Remove-CsClientVersionConfiguration
在範例 2 中，會刪除在站台範圍套用的所有用戶端版本組態設定。為了完成此工作，命令會先呼叫 Get-CsClientVersionConfiguration 搭配 Filter 參數，篩選值 "site:*" 可確保只會傳回 Identity 開頭為字串值 "site:" 的用戶端版本組態設定。開頭的設定。接著，這個篩選過的集合會傳送到 Remove-CsClientVersionConfiguration，以刪除集合中的每一個項目。
-------------------------- 範例 3 ------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False} | Remove-CsClientVersionConfiguration
在上述命令中，所有目前停用的用戶端版本組態設定皆會刪除。如果要執行這項作業，命令會先使用 Get-CsClientVersionConfiguration 傳回組織目前正在使用之所有用戶端版本組態設定的集合。傳回這項資料後，集合會傳送到 Where-Object 指令程式；該指令程式只會挑出 Enabled 內容等於 False 的設定。篩選後的集合隨後會傳送到 Remove-CsClientVersionConfiguration，這會刪除集合中的每個項目。