Set-CsPresencePolicy
上一次修改主题: 2012-03-25
修改现有的状态策略。
语法
Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
详细说明
状态信息(除了其他功能,使您可了解某个联系人是否有空参加即时消息会话)的作用不可估量。但同时,伴随着状态信息会产生相关的成本:状态订阅数量越多,就必须提供越多的网络带宽专门用于更新状态信息。如果担心网络带宽不足,则可能要限制任意一个用户可拥有的状态订阅的数量。
使用 CsPresencePolicy cmdlet 可管理状态订阅的两个重要方面:提示订阅者和类别订阅。在将您添加到其他用户的 Microsoft Lync 2010 联系人列表中时,默认情况下,您会收到一条弹出式通知,告知您已被添加到该列表中。在消除弹出式通知之前,每条通知都将视为一个提示订阅者。使用状态策略的 MaxPromptedSubscriber 属性可指定用户可拥有的最大未解除通知对话框数。(如果用户达到这个最大数量,则该用户将不会收到新的联系人通知,至少在解除其中某些对话框之前是这样。)
类别订阅表示对某种特定类别信息的请求;例如,请求日历数据的应用程序。通过 MaxCategorySubscription 属性,管理员可限制用户可拥有的类别订阅的数量。
在 Microsoft Lync Server 2010 版本之前,提示订阅者和类别订阅以全局形式进行管理。现在,通过 CsPresencePolicy cmdlet,可以在 global 作用域、site 作用域或每用户作用域来管理这些状态订阅。这样可控制带宽的使用,同时确保用户有权访问工作时所需的状态信息。
使用 Set-CsPresencePolicy cmdlet 可修改配置为在组织中使用的任何状态策略。修改状态策略就意味着更改 MaxPromptedSubscriber 属性和/或 MaxCategorySubscription 属性的值。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsPresencePolicy cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPresencePolicy"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
要修改的状态策略的唯一标识符。要修改全局策略,请使用此语法:-Identity global。要在站点范围内修改策略,请使用类似于这种形式的语法:-Identity "site:Redmond"。要修改每用户策略,请使用类似于这种形式的语法:-Identity "RedmondPresencePolicy"。 |
|
Instance |
可选 |
状态策略对象 |
允许您将对对象的引用传递到 cmdlet,而不是设置单个参数值。 |
Description |
可选 |
字符串 |
使管理员可以提供状态策略附带的其他文本。例如,Description 可能包含策略应分配给的目标用户的相关信息。 |
MaxCategorySubscription |
可选 |
整数 |
任何时候允许的最大类别订阅数。类别订阅表示对某种特定类别信息的请求;例如,请求日历数据的应用程序。 MaxCategorySubscription 可设置为 0 至 3000 之间的任何一个整数值;默认值为 1000。 |
MaxPromptedSubscriber |
可选 |
整数 |
用户在任何时候可以拥有的提示订阅者的最大数目。默认情况下,每次将您添加到其他用户的联系人列表中时,屏幕上都会显示一个通知对话框向您告知这一情况,并使您有机会执行如下操作:将该用户添加到您自己的联系人列表中,或阻止该用户查看您的状态。在采取措施并关闭该对话框之前,每个通知都计为一个提示订阅者。 MaxPromptedSubscriber 可以设置为 0 到 600 之间(包含边界值)的任意整数值;默认值为 200。如果将该值设置为 0,则用户在被添加到其他用户的联系人列表时不会收到任何通知。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 对象。Set-CsPresencePolicy 接受通过管道传递的状态策略对象的输入。
返回类型
Set-CsPresencePolicy 不返回任何值或对象。此 cmdlet 会修改 Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy 对象的现有实例。
示例
-------------------------- 示例 1 ------------------------
Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300
示例 1 中显示的命令修改每用户状态策略 RedmondPresencePolicy。在此示例中,MaxPromptedSubscriber 属性的值设置为 300。
-------------------------- 示例 2 ------------------------
Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300
示例 2 中显示的命令是示例 1 中使用的命令的一种变化形式;但是,这种情况下,对于配置为在组织中使用的所有状态策略,都将 MaxPromptedSubscriber 属性设置为 300。为此,该命令首先调用不带任何参数的 Get-CsPresencePolicy;这样将返回配置为在组织中使用的所有状态策略的集合。然后,将此集合通过管道传递给 Set-CsPresencePolicy,后者将集合中每个策略的 MaxPromptedSubscriber 值都更改为 300。
-------------------------- 示例 3 ------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300
示例 3 显示如何能够在组织中配置状态策略以确保任何策略的提示订户都不超过 300 个。为实现此任务,该命令首先调用不带任何参数的 Get-CsPresencePolicy,以返回组织中所有状态策略的集合。然后,将此集合通过管道传递给 Where-Object cmdlet,后者仅选取 MaxPromptedSubscriber 策略的值大于 300 的策略。然后,将筛选出的集合通过管道传递给 Set-CsPresencePolicy,后者接收集合中的每个策略,并将提示订户最大数设置为 300。因此,任何策略都不允许提示订户超过 300 个,但某些策略可能允许订户少于 300 个。