Get-CsClientVersionConfiguration
上次修改主題的時間： 2012-03-23
擷取組織所使用之指定用戶端版本組態設定集合的相關資訊。用戶端版本組態設定會決定 Microsoft Lync Server 2010 是否會檢查登入系統之每個用戶端應用程式的版本號碼。如果啟用用戶端版本篩選功能，用戶端應用程式是否能存取系統，則取決於在相關的用戶端版本原則中所設定的設定。
語法
Get-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsClientVersionConfiguration [-Filter <String>] [-LocalStore <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 時，會安裝並啟用一組通用的用戶端版本組態設定。這些設定會用於決定是否啟用用戶端版本篩選。除了通用設定外，用戶端版本組態設定也會在站台範圍套用；在那些狀況下，站台設定會優先於通用設定。
Get-CsClientVersionConfiguration 指令程式讓您能夠擷取組織目前所使用之用戶端版本組態設定的相關資訊。請注意，此指令程式不會傳回任何允許或不允許用戶端應用程式的相關資訊。若要擷取該資訊，請使用 Get-CsClientVersionPolicy。
另請注意，用戶端版本組態並非一個安全性功能。該技術可仰賴用戶端應用程式的自行報告，且不會嘗試確認應用程式是否真的是應用程式，而該應用程式的版本號碼就如其所聲明般。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsClientVersionConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientVersionConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
指出要傳回之用戶端版本組態設定集合的唯一識別碼。若要參考通用設定，請使用此語法：-Identity global。若要參照在此站台範圍設定的集合，請使用如下語法：-Identity site:Redmond。您無法在指定 Identity 時使用萬用字元。如果您必須使用萬用字元，請改為包含 Filter 參數。 如果未指定此參數，則 Get-CsClientVersionConfiguration 將傳回組織所使用的所有用戶端版本組態設定集合。 |
Filter |
選用 |
字串 |
讓您能夠使用萬用字元，以傳回一或多個用戶端版本組態設定的集合。若要傳回在站台範圍所設定之所有設定集合，請使用此語法：-Filter site:*。若要傳回在 Identity (您唯一可篩選的屬性) 中某處有字串值 "EMEA" 的所有設定集合，請使用此語法：-Filter *EMEA*。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取用戶端版本組態資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsClientVersionConfiguration 不會接受管線傳送的資料。
傳回類型
Get-CsClientVersionConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsClientVersionConfiguration
在第一個範例中，呼叫 Get-CsClientVersionConfiguration 時未指定其他任何參數。這會導致 Get-CsClientVersionConfiguration 傳回組織目前所使用之所有用戶端版本組態設定的集合。
-------------------------- 範例 2 --------------------------
Get-CsClientVersionConfiguration -Identity site:Redmond
在上述範例中，Get-CsClientVersionConfiguration 會傳回 Identity 為 site:Redmond 的所有用戶端版本組態設定。由於 Identity 必須是唯一的，因此這個命令絕對不會傳回一個以上的項目。
-------------------------- 範例 3 --------------------------
Get-CsClientVersionConfiguration -Filter "site:*"
範例 3 會傳回已在站台範圍內套用的所有用戶端版本組態設定。此項作業可透過包含 Filter 參數和篩選值 "site:*" 加以完成。篩選值會指示 Get-CsClientVersionConfiguration 僅傳回其 Identity 開頭字串值為 "site:" 的設定。
-------------------------- 範例 4 --------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False}
上述範例會傳回目前已停用的所有用戶端版本組態設定。為了執行此作業，命令會先使用 Get-CsClientVersionConfiguration，來傳回設定為要在組織內使用的所有用戶端版本設定集合。然後將此集合傳送到 Where-Object 指令程式，以套用篩選，將集合限制在 Enabled 屬性等於 False 的設定。