New-CsClientVersionPolicyRule

語法

New-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

用戶端版本原則規則可用來判斷允許登入 Lync Server 2010 的用戶端應用程式。當使用者嘗試登入 Lync Server 2010 時，該使用者的用戶端應用程式會傳送 SIP 標頭給伺服器，這個標頭包含與應用程式本身有關的詳細資訊，包括軟體的主要版本和組建編號。接著，系統會根據用戶端版本規則集合來檢查版本資訊，查看是否有任何規則要套用至該特定應用程式。例如，假設某位使用者嘗試使用 Microsoft Office Communicator 2007 R2 登入。在使用者可以登入 Lync Server 2010 之前，系統會檢查是否有適用於 Office Communicator 2007 R2 的用戶端版本規則。如果有這樣的規則，Lync Server 2010 就會採取此規則指定的行動。該動作必須是下列任一項：

Allow。允許使用者登入。

AllowAndUpgrade。允許使用者登入，並自動將使用者的 Communicator 2007 R2 複本升級為最新版本的 Lync。會視您設定系統的方式而定，使用 Microsoft Update 或 Windows Server Update Services 執行升級。

AllowWithUrl。允許使用者登入，並顯示訊息以指出使用者可以下載及安裝 Lync 最新版本的 URL。該 URL 必須指向您自己建立的網站；而不是指向安裝 Lync Server 時系統為您建立的網站。

Block。不允許使用者登入。

BlockAndUpgrade。不允許使用者登入，但會自動將使用者的 Communicator 2007 R2 複本升級為最新版本的 Lync。接下來，使用者便能嘗試使用新的用戶端應用程式登入。會視您設定系統的方式而定，使用 Microsoft Update 或 Windows Server Update Services 執行升級。

BlockWithUrl。不允許使用者登入，但會顯示訊息以指出使用者可下載及安裝最新版本之 Lync 的 URL。該 URL 必須指向您自己建立的網站；而不是指向安裝 Lync Server 時系統為您建立的網站。

系統會將用戶端版本原則規則收集在用戶端版本原則中。用戶端版本原則是一種可在全域範圍、站台範圍、服務範圍 (登錄器服務) 或個別使用者範圍內設定的原則。您可以使用 New-CsClientVersionPolicyRule 指令程式來建立新的用戶端版本規則。在建立新規則時，您還必須指定規則的 Identity；規則的 Identity 是由範圍 (如 site:Redmond) 和全域唯一識別碼 (GUID) 所組成。您可以自行拼湊 Identity，或提供範圍 (Parent 參數) 和 GUID (RuleId 參數)，再由 New-CsClientVerisonPolicyRule 為您建立 Identity。

請注意，用戶端版本原則不適用於同盟使用者；而是同盟使用者受到本身組織中使用的用戶端版本原則所約束。例如，假設某位同盟使用者使用用戶端 A (此為同盟組織所允許的用戶端)。只要同盟組織允許使用用戶端 A，這個使用者就可以使用該用戶端與您的組織通訊。即使您的用戶端版本原則會封鎖使用用戶端 A，此情況也成立。在您組織中強制執行的用戶端版本原則不會覆寫同盟組織中使用者的用戶端版本原則。

誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsClientVersionPolicyRule Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientVersionPolicyRule"}

參數

輸入類型

無。New-CsClientVersionPolicyRule 不會接受管線傳送的輸入。

傳回類型

New-CsClientVersionPolicyRule 會建立 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 物件的新執行個體。

範例

-------------------------- 範例 1 ------------------------

$x = [guid]::NewGuid()

New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse

範例 1 示範如何建立新用戶端版本原則規則。原則規則具有由以下兩部分組成的 Identity：要指派宣告的範圍和 36 個字元的 GUID。在建立新的用戶端版本原則規則時，首先需要使用 .NET Framework 方法 NewGuid 來建立新的 GUID。範例的第一個命令可實現此步驟，而產生的 GUID 則會儲存在變數 $x 中。

完成 GUID 的建立後，您便可以使用 New-CsClientVersionPolicyRule 來建立新規則。此命令使用 4 個參數：Parent：其參數值代表新規則的範圍 (site:Redmond)；RuleId：其參數值 $x 代表新建立的 GUID；MajorVersion (4)；和 UserAgent (InHouse)。在本案例中，UserAgent 參數代表內部的用戶端應用程式。

-------------------------- 範例 2 ------------------------

$x = [guid]::NewGuid()

$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4 
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z

範例 2 所示的命令是範例 1 命令的變化：不過在此案例中，新規則最初只會建立於記憶體中，稍後才會新增至 Lync Server 2010。為了執行此作業，範例的第一個命令會建立 Identity 的 GUID 部分。第二個命令會建立只存在於記憶體中的新用戶端版本原則規則。InMemory 參數可確保規則只存在於記憶體中，同時不會立即新增至 Lync Server 2010 基礎結構內。如範例 1 所示，Parent 和 RuleId 參數可用來指定新規則的範圍和 GUID，因此這兩個元件可構成規則的 Identity。

在建立虛擬規則後，後續的兩個命令可分別用來指派 MajorVersion 和 UserAgent 屬性的值。在完成上述作業後，範例中的最後一個命令 (連同 Set-CsClientVersionPolicyRule 指令程式) 可用來建立實際的用戶端版本原則規則，並將規則指派給 Redmond 站台。

請參閱

其他資源

Get-CsClientVersionPolicyRule
Remove-CsClientVersionPolicyRule
Set-CsClientVersionPolicyRule