Get-CsClientVersionPolicyRule
上一次修改主题： 2012-03-23
返回配置为在组织中使用的客户端版本策略规则。
语法
Get-CsClientVersionPolicyRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsClientVersionPolicyRule [-Filter <String>] [-LocalStore <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 服务）或每用户作用域配置这些策略。Get-CsClientVersionPolicyRule cmdlet 为管理员提供了一种查看有关配置为在其组织中使用的每个策略规则的详细信息的方法。
务必注意，客户端版本策略不适用于联盟用户，联盟用户应遵守其组织中使用的客户端版本策略。例如，假设一个联盟用户使用客户端 A（即联盟组织允许使用的客户端）。只要联盟组织允许使用客户端 A，该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsClientVersionPolicyRule cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientVersionPolicyRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的客户端版本策略规则的唯一标识符。客户端版本规则的 Identity 由配置该规则的作用域和一个全局唯一标识符 (GUID) 组成。这意味着规则的 Identity 类似如下：site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.由于 GUID 不便于记忆和使用，因此帮助主题示例部分列出了能够标识要返回的规则的备用方法。 如果未指定此参数，将返回配置为可供使用的所有客户端版本策略规则。 |
Filter |
可选 |
字符串 |
使您可以使用通配符指定要返回的客户端版本策略规则。例如，要返回为 Redmond 站点配置的所有规则，请使用以下语法：-Filter "site:Redmond/*"。 不能在同一个命令中同时使用 Filter 和 Identity 参数。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索客户端版本策略规则数据。 |
输入类型
无。Get-CsClientVersionPolicyRule 不接受通过管道传递的输入。
返回类型
Get-CsClientVersionPolicyRule 返回 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsClientVersionPolicyRule
示例 1 返回有关组织中当前正在使用的所有客户端版本策略规则的信息。
-------------------------- 示例 2 --------------------------
Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"
在示例 2 中，返回有关单个客户端版本策略规则的信息：Identity 为 Global/2336c611-a243-4c5d-994b-eea8a524d0e4 的规则。
-------------------------- 示例 3 --------------------------
Get-CsClientVersionPolicyRule -Filter "Global/*"
上述命令返回在 global 作用域配置的所有客户端版本策略规则。为执行此操作，该命令使用 Filter 参数和筛选器值“Global/*”。该筛选器值可确保仅返回 Identity 以字符串值“Global/”开头的规则。
-------------------------- 示例 4 --------------------------
Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False}
示例 4 中显示的命令返回当前禁用的所有客户端版本策略规则。为执行此任务，该命令首先调用 Get-CsClientVersionPolicy 以返回所有可用客户端策略规则的集合。然后，将此集合通过管道传递到 Where-Object cmdlet，后者将挑选出 Enabled 属性等于 False 的规则。
-------------------------- 示例 5 --------------------------
Get-CsClientVersionPolicyRule | Where-Object {$_.Action -eq "Block"}
上述命令返回阻止客户端应用程序登录的所有客户端版本策略规则。为执行此操作，该命令首先调用不带任何参数的 Get-CsClientVersionPolicy，以返回当前正在使用的所有规则的集合。然后将该集合通过管道传递到 Where-Object cmdlet，后者将仅选择 Action 属性等于 Block 的规则。