Set-CsClientVersionPolicy
上一次修改主题： 2012-03-26
修改现有的客户端版本策略。通过客户端版本策略，您可以指定允许登录到 Microsoft Lync Server 2010 系统的客户端（如 Microsoft Office Communicator 2007 R2）。
语法
Set-CsClientVersionPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsClientVersionPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 中登录。
可随时修改客户端版本策略；修改客户端版本策略通常指添加新规则、删除现有规则，或者修改现有规则的属性（例如，将规则操作从“允许”更改为“阻止”）。可以使用 Set-CsClientVersionPolicy cmdlet 进行这些更改。但是，您可能会发现使用 CsClientVersionPolicyRule cmdlet 进行这些修改更容易。
另一方面，通过 Set-CsClientVersionPolicy，您可以轻松将一个客户端版本策略中的完整规则集复制到另一个客户端版本策略。有关详细信息，请参阅本帮助主题中的示例部分。
务必注意，客户端版本策略不适用于联盟用户，联盟用户应遵守其组织中使用的客户端版本策略。例如，假设一个联盟用户使用客户端 A（即联盟组织允许使用的客户端）。只要联盟组织允许使用客户端 A，该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsClientVersionPolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientVersionPolicy\b"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的策略的唯一标识符。要修改全局策略，请使用以下语法：-Identity global。要修改在 site 作用域配置的策略，请使用类似如下的语法：-Identity "site:Redmond"。要修改在 service 作用域配置的策略，请使用类似如下的语法：-Identity "Registrar:atl-cs-001.litwareinc.com"。Registrar 服务是唯一可以托管客户端版本策略的服务。 此外，也可以使用此 cmdlet 修改每用户策略。要修改每用户策略，请使用类似如下的语法：-Identity "SalesDepartmentPolicy"。 如果未包括此参数，则 Set-CsClientVersionPolicy 将修改全局策略。 |
Instance |
可选 |
ClientVersionPolicy 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Description |
可选 |
字符串 |
用于提供有关策略的说明信息。例如，您可以提供描述策略应分配给的用户的信息。 |
Rules |
可选 |
PS 列表修饰符 |
已分配给策略的各个客户端策略规则的集合。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 对象。Remove-CsClientVersionPolicy 接受通过管道传递的客户端版本策略对象的实例。
返回类型
Set-CsClientVersionPolicy 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsClientVersionPolicy -Identity site:Redmond -Rules $Null
$x = Get-CsClientVersionPolicy -Identity site:Dublin | Select-Object -ExpandProperty Rules
Set-CsClientVersionPolicy -Identity site:Redmond -Rules $x
示例 1 中显示的命令将一个客户端版本策略中的所有客户端版本规则复制到另一个客户端版本策略。为执行此操作，此示例中的第一个命令使用 Set-CsClientVersionPolicy 删除策略 site:Redmond 中的所有规则；这是通过将 Rules 属性的值设置为空实现的。删除规则后，示例中的第二个命令使用 Get-CsClientVersionPolicy 检索为 site:Dublin 策略配置的所有客户端版本策略规则。将这些规则存储在一个名为 $x 的变量中。
在最后一个命令中，再次调用 Set-CsClientVersionPolicy，这次将 Redmond 策略的 Rules 属性设置为 $x。这样可有效复制 site:Dublin 策略中的所有规则并将它们添加到 site:Redmond 策略。