Remove-CsClientVersionPolicy

 

上一次修改主题: 2012-03-26

删除指定的客户端版本策略。通过客户端版本策略,您可以指定能够登录到 Microsoft Lync Server 2010 系统的客户端(如 Microsoft Office Communicator 2007 R2)。

语法

Remove-CsClientVersionPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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,这是因为 Communicator 2007 R2 不支持与 Lync 2010 相同的功能。但是,由于硬件或软件冲突,您可能也有一组无法升级到 Lync 2010 的用户。在这种情况下,您可以创建一个单独的规则(和一个单独的客户端版本策略),以允许这些用户从 Communicator 2007 R2 中登录。

您可以使用 New-CsClientVersionPolicy cmdlet 创建新策略。这些自定义策略以后可通过运行 Remove-CsClientVersionPolicy cmdlet 予以删除。当您删除某个客户端版本策略时,以前受该策略管辖的用户将自动继承管理层次结构中的下一个策略。例如,如果您删除每用户策略,用户将自动受相应的服务策略管辖。如果不存在任何服务策略,用户将受相应的站点策略管辖。如果不存在任何站点策略,用户将受全局策略管理。

注意,始终都会有全局策略,这意味着不会有用户处于不受客户端版本策略管理的状态。尽管您可以对全局策略运行 Remove-CsClientVersionPolicy,但这不会真正删除该策略。而是将所有策略规则都重置为其默认值。

务必注意,客户端版本策略不适用于联盟用户,联盟用户应遵守其组织中使用的客户端版本策略。例如,假设一个联盟用户使用客户端 A(即联盟组织允许使用的客户端)。只要联盟组织允许使用客户端 A,该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。

谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsClientVersionPolicy cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsClientVersionPolicy\b"}

参数

参数 必需 类型 描述

Identity

必需

Xds 标识

要删除的策略的唯一标识符。要删除在 site 作用域配置的策略,请使用类似如下的语法:-Identity "site:Redmond"。要删除在 service 作用域配置的策略,请使用以下类似语法:-Identity "Registrar:atl-cs-001.litwareinc.com"。Registrar 服务是唯一可以托管客户端版本策略的服务。

您也可以删除每用户范围内的策略。要删除每用户策略,请使用类似语法:-Identity "SalesDepartmentPolicy"。

Force

可选

开关参数

禁止显示运行此命令时可能出现的任何非严重错误消息。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

开关参数

在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 对象。Remove-CsClientVersionPolicy 接受通过管道传递的客户端版本策略对象的实例。

返回类型

Remove-CsClientVersionPolicy 可删除 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy 对象的现有实例。

示例

-------------------------- 示例 1 --------------------------

Remove-CsClientVersionPolicy -Identity site:Redmond

示例 1 所示的命令删除了 Redmond 站点的客户端版本策略。

-------------------------- 示例 2 --------------------------

Get-CsClientVersionPolicy -Filter tag:* | Remove-CsClientVersionPolicy

示例 2 所示的命令删除了每用户作用域内配置的所有客户端版本策略。为执行此操作,该命令首先调用带有 Filter 参数的 Get-CsClientVersionPolicy;筛选器值“tag:*”将返回的数据限制为在每用户作用域配置的策略。然后,将筛选出的此集合通过管道传递给 Remove-CsClientVersionPolicy,后者将删除集合中的每项。