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