Set-CsClientVersionConfiguration
上次修改主題的時間： 2012-03-27
修改指定的用戶端版本組態設定集合。用戶端版本組態設定會決定 Microsoft Lync Server 2010 是否會檢查登入系統之每個用戶端應用程式的版本號碼。如果已啟用用戶端版本篩選，則該用戶端應用程式存取系統的能力將會根據適當用戶端版本原則中所設定的設定而定。
語法
Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 時，會安裝並啟用一組通用的用戶端版本組態設定。這些設定是用來判斷是否已啟用用戶端版本篩選。除了通用設定外，用戶端版本組態設定也會在站台範圍套用；在那些狀況下，站台設定會優先於通用設定。
Set-CsClientVersionConfiguration 指令程式可讓您修改現有的用戶端版本組態設定集合。
請注意，用戶端版本組態不是安全性功能。該技術可仰賴用戶端應用程式的自行報告，且不會嘗試確認應用程式是否真的是應用程式，而該應用程式的版本號碼就如其所聲明般。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsClientVersionConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientVersionConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
代表要修改之用戶端版本組態設定的唯一識別碼。若要修改通用設定，請使用類似如下的語法：-Identity global。若要修改指派至網站範圍的設定，請使用類似如下的語法："site:Redmond"。 如果未加入此參數，Set-CsClientVersionConfiguration 會自動設定通用設定。 |
Instance |
選用 |
ClientVersionPolicy 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
DefaultAction |
選用 |
字串 |
指出當使用者嘗試從無法在適當用戶端版本原則中找到其版本號碼的用戶端應用程式進行登入時，將會採取的行動。DefaultAction 必須設為下列其中一個值： Allow。允許用戶端應用程式登入。 AllowWithUrl。將允許用戶端應用程式登入。此外，對使用者顯示的訊息方塊會包含網頁的 URL，使用者可在此下載已核准的用戶端應用程式。應將此網頁的 URL 指定為 DefaultUrl 屬性值。 Block。禁止用戶端應用程式登入。 BlockWithUrl。禁止用戶端應用程式登入。但是，對使用者顯示的「拒絕存取」訊息方塊將會包含網頁的 URL，使用者可在此下載已核准的用戶端應用程式。應將此網頁的 URL 指定為 DefaultUrl 屬性值。 如果 Enabled 屬性設為 False，則會忽略此屬性。將 Enabled 屬性設定為 False 之後，則不會進行任何用戶端版本篩選。 |
DefaultUrl |
選用 |
字串 |
指定使用者可在該處下載已核准用戶端應用程式之網頁的 URL。如果有指定且 DefaultAction 設為 BlockWithURL，此 URL 將會出現在每次有使用者嘗試從不支援的用戶端應用程式登入時顯示的 [拒絕存取] 訊息方塊中。 |
Enabled |
選用 |
布林值 |
表示用戶端版本篩選已啟用或已停用。如果 Enabled 屬性為 True，則伺服器會檢查嘗試登入之每個用戶端應用程式的版本號碼，然後伺服器會根據適當的用戶端版本原則允許或拒絕存取。如果將 Enabled 屬性設定為 False，則將允許任何可以登入之用戶端應用程式進行登入。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
布林值 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 物件。Set-CsClientVersionConfiguration 接受管線傳送的用戶端版本組態物件執行個體。
傳回類型
Set-CsClientVersionConfiguration 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False
在範例 1 中，Set-CsClientVersionConfiguration 是用來修改 Identity 為 "site:Redmond" 的設定集合。在此例中，Enabled 參數設為 False 以停用用戶端版本組態設定。
-------------------------- 範例 2 --------------------------
Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"
在上述範例中，會針對組織中目前使用中的所有用戶端版本組態設定，修改 DefaultUrl 屬性。若要這樣做，此命令會先呼叫 Get-CsClientVersionConfiguration 但不加上其他任何參數，以傳回所有用戶端版本組態設定。接著，該資訊會傳送到 Set-CsClientVersionConfiguration,，將每個組態集合之 DefaultUrl 的值設為 https://litwareinc.com/csclients。
-------------------------- 範例 3 --------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"
在範例 3 中，會針對 DefaultAction 目前設為 Block 的所有用戶端版本組態設定進行修改。為了執行此作業，命令會先使用 Get-CsClientVersionConfiguration，傳回目前使用中的所有用戶端版本組態設定。接著，該資訊會傳送到 Where-Object 指令程式，只挑出其 DefaultAction 內容等於 "Block" 的項目。接下來，該篩選過的集合會傳送到 Set-CsClientVersionConfiguration，並對集合中的每個項目執行兩個動作：1) 將 DefaultAction 設為 BlockWithUrl，以及 2) 將 DefaultUrl 設為 https://litwareinc.com/csclients。