Remove-CsClientVersionPolicyRule
上一次修改主题： 2012-03-25
删除配置为在组织中使用的一个或多个客户端版本策略规则。
语法
Remove-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
客户端版本规则用于确定允许哪些客户端应用程序登录 Microsoft Lync Server 2010。用户尝试登录到 Lync Server 2010 时，其客户端应用程序会向该服务器发送 SIP 标头，此标头包括有关应用程序自身的详细信息（包括软件的主版本号、次版本号和内部版本号）。然后，按照客户端版本规则的集合，检查版本信息，以查看所有规则是否适用于该特定应用程序。例如，假设一个用户尝试使用 Microsoft Office Communicator 2007 R2 进行登录。在用户可以登录之前，系统将检查以确认是否存在适用于 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 服务）或每用户作用域配置的策略）中收集客户端版本规则。通过 Remove-CsClientVersionPolicyRule cmdlet，您可以删除配置为在组织中使用的一个或多个客户端策略规则。可以从任意客户端版本策略（包括全局策略）删除这些规则。
务必注意，客户端版本策略不适用于联盟用户，联盟用户应遵守其组织中使用的客户端版本策略。例如，假设一个联盟用户使用客户端 A（即联盟组织允许使用的客户端）。只要联盟组织允许使用客户端 A，该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsClientVersionPolicyRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsClientVersionPolicyRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的客户端版本策略规则的唯一标识符。客户端版本规则的 Identity 由已配置该规则的作用域以及全局唯一标识符 (GUID) 组成。这意味着规则的 Identity 类似于：site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 对象。Remove-CsClientVersionPolicyRule 接受通过管道传递的客户端版本规则对象的实例。
返回类型
无。Remove-CsClientVersionPolicyRule 会删除 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820
示例 1 中显示的命令将删除 Identity 为 site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 的客户端版本策略规则。由于 Identity 必须唯一，所以此命令最多只会删除一个规则。
-------------------------- 示例 2 ------------------------
Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule
上述命令将删除已为 Redmond 站点配置的所有客户端版本策略规则。为执行此操作，命令首先调用带 Filter 参数的 Get-CsClientVersionPolicyRule；筛选器值“site:Redmond/”会将返回的数据限制为 Identity 以字符串值“site:Redmond/”开头的策略规则。然后，将筛选出的集合通过管道传递到 Remove-CsClientVersionPolicyRule，后者会删除该集合中的每一项。
-------------------------- 示例 3 ------------------------
Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False} | Remove-CsClientVersionPolicyRule
示例 3 将删除所有当前禁用的客户端版本策略规则。为执行此操作，命令首先调用不带任何参数的 Get-CsClientVersionPolicyRule，以返回组织中当前使用的所有策略规则的集合。然后，将此集合通过管道传递到 Where-Object cmdlet，后者仅挑选出 Enabled 属性等于 False 的所有规则。接着，将筛选出的集合通过管道传递到 Remove-CsClientVersionPolicyRule，后者会删除该集合中的每一项。