Set-CsClientVersionPolicyRule
上一次修改主题： 2012-03-26
修改当前配置为在组织中使用的一个或多个客户端版本策略规则。
语法
Set-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>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]
Set-CsClientVersionPolicyRule [-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>] [-Instance <PSObject>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]
详细说明
客户端版本规则用于确定允许哪些客户端应用程序登录 Microsoft 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 时不会为您创建此类网站。
在客户端版本策略（可在 global 作用域、site 作用域、service 作用域（Registrar 服务）或每用户作用域配置的策略）中收集客户端版本规则。Set-CsClientVersionPolicyRule cmdlet 提供了一种修改现有客户端版本规则的属性的方法。
务必注意，客户端版本策略不适用于联盟用户，联盟用户应遵守其组织中使用的客户端版本策略。例如，假设一个联盟用户使用客户端 A（即联盟组织允许使用的客户端）。只要联盟组织允许使用客户端 A，该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsClientVersionPolicyRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientVersionPolicyRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要修改的客户端版本策略规则的唯一标识符。客户端版本规则的 Identity 由规则所配置的范围和一个全局唯一的标识符 (GUID) 组成。这意味着规则的 Identity 类似于：site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83。 |
Instance |
可选 |
规则对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Action |
可选 |
PS 列表修饰符 |
触发该规则时（即有人尝试使用指定软件进行登录时）所要采取的操作。有效值包括： Allow。将允许用户登录。 AllowWithUrl。允许用户登录，并显示消息，将用户指向可下载和安装最新版本 Lync 的 URL。 AllowAndUpgrade。允许用户登录，并且其 Communicator 副本将自动升级至最新版本的 Lync。 Block。不允许用户登录。 BlockWithUrl。不允许用户登录，但会显示消息，将用户指向可下载和安装最新版本 Lync 的 URL。 BlockAndUpgrade。不允许用户登录，但其 Communicator 副本将自动升级至最新版本的 Lync。然后，用户可以尝试使用新的客户端应用程序进行登录。 |
ActionUrl |
可选 |
字符串 |
用户可以下载最新版本 Lync 的 URL。如果 Action 设置为 BlockWithUrl 或 AllowWithUrl，则需要此属性。 |
BuildNumber |
可选 |
整数 |
软件的内部版本号。例如，如果您的 Communicator 副本是 2.0.6362.111 版，则 BuildNumber 为 6362。内部版本号代表开发过程中软件的内部版本，可帮助确保您使用的是最终发行版，而不是预发行版本。 |
CompareOp |
可选 |
PS 列表修饰符 |
比较运算符，用于确定尝试登录的客户端软件是在规则中指定的版本之前、之后还是同时发行的。有效值包括： EQL（等于） NEQ（不等于） GTR（大于） GEQ（大于或等于） LSS（小于） LEQ（小于或等于） |
Description |
可选 |
字符串 |
使管理员可以提供有关客户端版本规则的额外信息。例如，Description 可能包含当认为应当更改规则时应与谁联系的有关信息。 |
Enabled |
可选 |
布尔值 |
指示是否要使用客户端版本规则。如果 Enabled 属性设置为 False，则在用户尝试使用指定软件进行登录时将忽略该规则。默认值为 True。 |
MajorVersion |
可选 |
整数 |
软件的主版本。例如，如果您的 Communicator 副本为 2.0.6362.111 版，则 MajorVersion 为 2。主版本相当于软件的主要发行版。 |
MinorVersion |
可选 |
整数 |
软件的次版本。例如，如果您的 Communicator 副本为 2.0.6362.111 版，则 MinorVersion 为 0。次版本相当于软件的临时发行版。 |
Priority |
可选 |
整数 |
规则的相对优先级。规则按优先级顺序进行处理，首先处理优先级为 0 的规则，然后处理优先级为 1 的规则，依此类推。如果您指定的优先级已在使用中，则新规则将使用该优先级，而其他规则将相应地进行重新编号。 |
QfeNumber |
可选 |
整数 |
软件的快速修补工程编号。例如，如果您的 Communicator 副本的版本为 2.0.6362.111，则 QfeNumber 为 111。QFE 编号表示软件正式发行之后提供的计划内应用程序更新。 |
UserAgent |
可选 |
字符串 |
用于标识软件客户端的指示符。例如，OC 是 Communicator 的用户代理标识。Get-CsClientVersionConfiguration cmdlet 为每个用户代理指派提供对应的友好名称。 |
UserAgentFullName |
可选 |
字符串 |
使管理员能够提供用户代理的友好名称。例如，管理员无需依赖用户代理 UCCP 来标识代理，而是可以完整地写出名称：Microsoft 统一通信客户端。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 对象。Set-CsClientVersionPolicyRule 接受通过管道传递的客户端版本规则对象的实例。
返回类型
无。Set-CsClientVersionPolicyRule 修改 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Set-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 -Enabled $False
示例 1 所示的命令禁用了 Identity 为 site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 的客户端版本策略规则。为禁用该规则，该命令加入了 Enabled 参数和参数值 $False。
-------------------------- 示例 2 ------------------------
Get-CsClientVersionPolicyRule -Filter "site:Redmond*" | Set-CsClientVersionPolicyRule -Description "Client policy rules for Redmond"
示例 2 向分配给 Redmond 站点的所有客户端版本策略规则添加了一项常规描述。为此，该命令首先调用带 Filter 参数的 Get-CsClientVersionPolicyRule；筛选器值“site:Redmond”将返回的数据限定为分配给 Redmond 站点的策略规则。然后，将此集合通过管道传递给 Set-CsClientVersionPolicyRule cmdlet，后者向该集合中的每项规则分配“Client policy rules for Redmond”作为 Description。
-------------------------- 示例 3 ------------------------
Get-CsClientVersionPolicyRule | Where-Object {$_.UserAgent -eq "UCCP"} | Set-CsClientVersionPolicyRule -Action "Block"
上述命令阻止任何引用统一通信客户端平台 (UCCP) 作为用户代理的客户端版本策略规则使用 UCCP 客户端。为实现此任务，该命令首先调用 Get-CsClientVersionPolicyRule，以检索当前正在使用的所有客户端策略规则的集合。然后，将此集合通过管道传递给 Where-Object cmdlet，后者仅挑选出 UserAgent 属性等于 (-eq) UCCP 的那些规则。然后，将筛选出的集合通过管道传递给 Set-CsClientVersionPolicyRule cmdlet，后者将接收集合中的每项规则，并将 Action 属性设置为 Block。