Remove-CsClientPolicy

 

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

删除现有的客户端策略。客户端策略的功能之一是有助于确定可提供给用户的 Microsoft Lync 2010 的功能;例如,可为一些用户授予传输文件的权利,而对其他用户拒绝授予这项权利。

语法

Remove-CsClientPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

详细说明

在 Lync Server 2010 中,客户端策略替换了以前版本的产品中使用的组策略设置。在 Microsoft Office Communicator 2007 和 Microsoft Office Communicator 2007 R2 中,组策略用于帮助确定哪些用户可以处理 Communicator 和其他客户端;例如,有些组策略设置确定用户能否保存其即时消息会话的脚本,能否将 Microsoft Outlook 中的信息合并到其状态信息中,以及用户能否在即时消息中包含图释或带格式的文本。

该技术与组策略一样很有用处,但该技术应用于 Lync Server 2010 时仍有一些局限性。首先,组策略旨在基于每域或每组织单位 (OU) 进行应用;这使得很难将策略面向一组精选的用户(例如在一个特定部门工作的所有用户,或具有特定职务的所有用户)。另一方面,组策略仅适用于登录到域且使用计算机登录的用户;它不会应用到通过 Internet 访问 Lync Server 2010 或使用手机访问系统的用户。这意味着,根据用户用于登录的设备或登录位置的不同,同一个用户可能具有不同的体验。

为了帮助解决这些不一致性问题,Lync Server 2010 使用客户端策略来代替组策略。每次用户访问系统时,无论用户从何位置登录,以及使用何种类型的设备登录,都将应用客户端策略。此外,客户端策略(与其他 Lync Server 2010 策略一样)可轻松面向所选用户组。您甚至可以创建分配给单个用户的自定义策略。

可在全局、站点和每用户范围内配置客户端策略。可在以后使用 Remove-CsClientPolicy cmdlet 删除已在 site 或每用户作用域配置的策略。还可以对全局策略运行 Remove-CsClientPolicy。这种情况下不会删除全局策略;之所以这样,是因为无法删除全局策略。但是,会将全局策略中的所有属性都重置为其默认值。

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

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

参数

参数 必需 类型 描述

Identity

必需

Xds 标识

要删除的客户端策略的唯一标识符。要“删除”全局策略,请使用以下语法:-Identity global。(请注意,无法实际删除全局策略。但该策略中的所有属性将重置为其默认值。)要删除站点策略,请使用类似如下的语法:-Identity "site:Redmond"。要删除每用户策略,请使用类似如下的语法:-Identity "SalesDepartmentPolicy"。指定策略 Identity 时不能使用通配符。

Force

可选

开关参数

如果此参数存在,则即使策略当前分配到的用户最少为一个,该策略也将自动删除。如果此参数不存在,则 Remove-CsClientPolicy 将不自动删除已至少分配给一个用户的每用户策略。而是会显示一个确认提示,询问您是否确实要删除该策略。必须回答“是”(按 Y 键),然后该命令才会继续,并将删除策略。

WhatIf

可选

开关参数

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

Confirm

可选

开关参数

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

输入类型

Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy 对象。Remove-CsClientPolicy 接受通过管道传递的客户端策略对象的实例。

返回类型

Remove-CsClientPolicy 不返回值。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy 对象的实例。

示例

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

Remove-CsClientPolicy -Identity SalesPolicy

示例 1 中使用 Remove-CsClientPolicy 删除 Identity 为 SalesPolicy 的客户端策略。

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

Get-CsClientPolicy -Filter "tag:*" | Remove-CsClientPolicy

示例 2 中使用 Get-CsClientPolicyRemove-CsClientPolicy 删除已在每用户作用域内配置的所有客户端策略。该命令使用 Get-CsClientPolicy 和 Filter 参数返回在每用户作用域配置的所有客户端策略的集合;筛选器值“tag:*”指示 Get-CsClientPolicy 将检索的数据限制为 Identity 以字符串值“tag:”开头的客户端策略。然后,将筛选出的集合通过管道传递给 Remove-CsClientPolicy,后者删除集合中的每个策略。

-------------------------- 示例 3 --------------------------

Get-CsClientPolicy | Where-Object {$_.EnableAppearOffline -eq $True} | Remove-CsClientPolicy

上述命令删除 EnableAppearOffline 属性设置为 True 的所有客户端策略。为此,首先调用不带任何其他参数的 Get-CsClientPolicy;这样将返回配置为在组织中使用的所有客户端策略的集合。然后,将此集合通过管道传递给 Where-Object cmdlet,后者仅选取 EnableAppearOffline 属性等于 True 的那些策略。接下来,将筛选出的此集合通过管道传递给 Remove-CsClientPolicy,后者删除集合中的每个策略。