Remove-CsPresencePolicy
上一次修改主题： 2012-03-26
删除指定的状态策略。
语法
Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
状态信息非常重要，其中的一方面是，状态信息可让您知道联系人是否有空参与即时消息对话。但同时，状态信息也存在一定的相关成本：您具有的状态订阅越多，更新状态信息所需的网络带宽也就越大。如果网络带宽是需要考虑的一项因素，您可能想要限制任一用户可拥有的状态订阅数量。
CsPresencePolicy cmdlet 用于管理状态订阅的两个重要方面：提示订阅者和类别订阅。在将您添加到其他用户的 Microsoft Lync 2010 联系人列表中时，默认情况下，您会收到一条弹出式通知，告知您已被添加到该列表中。在消除弹出式通知之前，每条通知都将视为一个提示订阅者。状态策略的 MaxPromptedSubscriber 属性用于指定用户可以拥有的未处理通知对话框的最大数量。（如果用户达到最大数量，则在至少已消除其中一些对话框之前，将不会收到新的联系人通知。）
类别订阅表示对特定类别信息的请求，例如，请求日历数据的应用程序。通过 MaxCategorySubscription 属性，管理员可以对用户能拥有的类别订阅数量进行限制。
在 Microsoft Lync Server 2010 版本之前，提示订阅者和类别订阅以全局形式进行管理。现在，通过 CsPresencePolicy cmdlet，可以在 global 作用域、site 作用域或每用户作用域来管理这些状态订阅。这样，您就可以控制带宽使用，同时确保用户有权访问执行其作业所需的状态信息。
可以随时运行 Remove-CsPresencePolicy cmdlet 删除在 site 作用域或每用户作用域创建的策略。此 cmdlet 还可以针对全局策略运行；但是，如果您执行此操作，将不会实际删除全局策略。(Lync Server 2010 不允许删除全局策略。）全局策略中的两个属性 MaxPromptedSubscriber 和 MaxCategorySubscription 将重置为其默认值。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsPresencePolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPresencePolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的状态策略的唯一标识符。要删除在 site 作用域配置的策略，请使用以下类似语法：-Identity "site:Redmond"。要删除在每用户作用域配置的策略，请使用以下类似语法：-Identity "RedmondPresencePolicy"。 Remove-CsPresencePolicy 还可以针对全局策略运行；为执行此操作，请使用以下语法：-Identity global。但是请注意，不会删除全局策略。该策略中的属性将重置为其默认值。 |
Force |
可选 |
开关参数 |
如果存在，Remove-CsPresencePolicy 将删除每用户策略，即使策略当前已分配给至少一个用户也是如此。如果不存在，则在删除正在使用中的策略之前，系统会要求您确认删除请求。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 对象。Remove-CsPresencePolicy 接受通过管道传递的状态策略对象的输入。
返回类型
无。Remove-CsPresencePolicy 删除 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"
上述命令删除 Identity 为 RedmondPresencePolicy 的每用户状态策略。
-------------------------- 示例 2 --------------------------
Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy
示例 2 中显示的命令删除在每用户作用域配置的所有状态策略。（这些策略的 Identity 以前缀“tag:”开头）为了执行此任务，该命令首先使用 Get-CsPresencePolicy 和 Filter 参数返回所有每用户状态策略；筛选器值“tag:*”将返回的数据限制为 Identity 以字符串值“tag:”开头的策略。然后，将筛选出的集合通过管道传递到 Remove-CsPresencePolicy，以删除集合中的每个策略。
-------------------------- 示例 3 --------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | Remove-CsPresencePolicy
示例 3 删除所有允许 500 个以上的提示订阅者的状态策略。为执行此操作，该命令首先调用不带任何参数的 Get-CsPresencePolicy，以便返回配置为在组织中使用的所有状态策略的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅挑选出 MaxPromptedSubscriber 属性大于 500 的策略。接下来，再将筛选出的集合通过管道传递到 Remove-CsPresencePolicy，后者会删除所有允许 500 个以上的提示订阅者的状态策略。