New-CsClientVersionPolicy
上次修改主題的時間： 2012-03-23
建立新的用戶端版本原則。用戶端版本原則可讓您指定哪些用戶端版本 (如 Microsoft Office Communicator 2007 R2) 可登入您的 Microsoft Lync Server 2010 系統。
語法
New-CsClientVersionPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
用戶端版本原則代表用戶端版本規則的集合；而用戶端版本規則用於決定允許登入 Lync Server 2010 的用戶端應用程式。當使用者嘗試登入 Lync Server 2010 時，該使用者的用戶端應用程式會傳送 SIP 標頭給伺服器，這個標頭包含與應用程式本身有關的詳細資訊，包括軟體的主要版本和組建編號。接著，系統會根據用戶端版本規則的集合檢查 SIP 標頭中所包含的版本資訊，以查看是否有任何規則適用於該特定應用程式。如果有這樣的規則，Lync Server 2010 就會採取此規則指定的行動。例如，規則可能會告知 Lync Server 2010 允許登入、封鎖登入，或允許登入，但是會以無訊息方式將用戶端應用程式升級為最新版本 (例如，將 Communicator 2007 R2 升級到 Microsoft Lync 2010)。
用戶端版本原則 (可套用至全域範圍、站台範圍、服務範圍 (僅登錄器服務)，或個別使用者範圍)，可讓您在決定哪些用戶端應用程式可用來存取系統時，擁有彈性。例如，一般而言，您可能想防止使用者使用 Communicator 2007 R2 登入 Lync Server 2010，因為舊版的用戶端應用程式與 Lync 2010 所支援的功能和特性並不同。但是，由於硬體或軟體衝突，您可能也想選取一組無法升級為 Lync 2010 的使用者。在該情況下，您可以建立個別的規則 (以及個別的用戶端版本原則)，允許那些使用者從 Communicator 2007 R2 登入。
但是請注意，匿名使用者僅會受到通用原則的影響。這是因為匿名使用者不會與站台或服務產生關聯，且無法指派個別使用者原則。
您可以使用 New-CsClientVersionPolicy 指令程式來建立新的用戶端版本規則。這些新原則可以在網站範圍、服務範圍 (僅登錄程式服務) 或個別使用者範圍建立。
請注意，用戶端版本原則不適用於同盟使用者；而是同盟使用者受到本身組織中使用的用戶端版本原則所約束。例如，假設某位同盟使用者使用用戶端 A (此為同盟組織所允許的用戶端)。只要同盟組織允許使用用戶端 A，這個使用者就可以使用該用戶端與您的組織通訊。即使您的用戶端版本原則會封鎖使用用戶端 A，此情況也成立。在您組織中強制執行的用戶端版本原則不會覆寫同盟組織中使用者的用戶端版本原則。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsClientVersionPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientVersionPolicy\b"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
要建立之原則的唯一識別碼。若要建立站台範圍的原則，請使用類似如下的語法：-Identity "site:Redmond"。若要建立服務範圍的原則，請使用類似以下的語法：-Identity "Registrar:atl-cs-001.litwareinc.com"。登錄程式服務是唯一可以主控用戶端版本原則的服務。 在個別使用者範圍也可以建立原則。若要建立個別使用者原則，請使用類似下列的語法：-Identity "SalesDepartmentPolicy"。 |
|
Description |
選用 |
字串 |
可讓您提供有關原則的說明文字。例如，您可以加入應該被指派原則之使用者的相關資訊。 |
Rules |
選用 |
PS 清單修飾詞 |
用戶端版本原則規則的集合。您可以使用 New-CsClientVersionPolicyRule 和 Remove-CsClientVersionPolicyRule 指令程式，在原則中新增或移除規則。若要在建立新原則時新增規則，請建立規則並將值以變數 (例如 $x) 儲存。然後，在建立新原則時，可以使用類似如下的語法： New-CsClientVersionPolicy –Identity "RedmondClientVersionPolicy" –Rules @{Add=$x} |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Get-CsClientVersionPolicy 不接受管線傳送的輸入。
傳回類型
New-CsClientVersionPolicy 會建立 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 物件的新執行個體。
範例
-------------------------- 範例 1 --------------------------
New-CsClientVersionPolicy -Identity site:Redmond
在範例 1 中，會建立 Redmond 網站的新用戶端版本原則。由於未指定任何參數 (強制的 Identity 參數除外)，因此新原則將會包含用戶端版本原則的所有預設值。
-------------------------- 範例 2 --------------------------
Get-CsSite | Select-Object Identity | ForEach-Object {New-CsClientVersionPolicy -Identity ("site:" + $_.Identity)}
範例 2 所示的命令會針對組織中的每個網站建立新的用戶端版本原則。若要完成此工作，此命令會先呼叫沒有其他任何參數的 Get-CsSite；這會傳回拓撲中所有站台的集合。接著，此站台集合會傳送到 Select-Object 指令程式，以擷取每個站台的 Identity 屬性。接著這些 Identity 會傳送至 ForEach-Object，以取得集合中的每個網站，並針對網站建立新的用戶端版本原則。