New-CsClientVersionPolicy
上一次修改主题： 2012-03-23
创建新的客户端版本策略。通过客户端版本策略，您可以指定能够登录到 Microsoft Lync Server 2010 系统的客户端版本（如 Microsoft Office Communicator 2007 R2）。
语法
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）。
客户端版本策略可应用于 global 作用域、site 作用域、service 作用域（仅限 Registrar 服务）或每用户作用域，使您能灵活地确定可用于访问系统的客户端应用程序。例如，通常情况下，您可能要阻止用户使用 Communicator 2007 R2 登录到 Lync Server 2010；当旧版本的客户端应用程序不支持与 Lync 2010 相同的功能时，您可能要执行该操作。但是，由于硬件或软件冲突，也可能会存在一组无法升级到 Lync 2010 的用户。在这种情况下，您可以创建一个单独的规则（和一个单独的客户端版本策略），以允许这些用户从 Communicator 2007 R2 中登录。
但请注意，匿名用户只受全局策略的影响。这是因为，匿名用户不与网站或服务关联，并且不能为其分配每用户策略。
可使用 New-CsClientVersionPolicy cmdlet 创建新的客户端版本策略。这些新策略可以在站点作用域、服务作用域（仅限 Registrar 服务）或每用户作用域创建。
务必注意，客户端版本策略不适用于联盟用户，联盟用户应遵守其组织中使用的客户端版本策略。例如，假设一个联盟用户使用客户端 A（即联盟组织允许使用的客户端）。只要联盟组织允许使用客户端 A，该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsClientVersionPolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientVersionPolicy\b"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
要创建的策略的唯一标识符。要在 site 作用域创建策略，请使用类似语法：-Identity "site:Redmond"。要在 service 作用域创建策略，请使用类似语法：-Identity "Registrar:atl-cs-001.litwareinc.com"。Registrar 服务是可以托管客户端版本策略的唯一服务。 您也可以创建每用户作用域内的策略。要创建每用户策略，请使用类似如下的语法：-Identity "SalesDepartmentPolicy"。 |
|
Description |
可选 |
字符串 |
使您能够提供有关策略的说明文本。例如，可以包含有关策略应分配到的用户的信息。 |
Rules |
可选 |
PS 列表修饰符 |
客户端版本策略规则的集合。通过 New-CsClientVersionPolicyRule 和 Remove-CsClientVersionPolicyRule cmdlet，可以在策略中添加和删除规则。要在创建新策略时添加规则，请创建规则，并且在变量（例如，$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 cmdlet，该 cmdlet 将提取每个站点的 Identity 属性。接下来，将这些标识通过管道传递到 ForEach-Object，后者会获取集合中的每一个站点，并为该站点创建新的客户端版本策略。