Grant-CsPresencePolicy
上一次修改主题： 2012-03-23
向用户或用户组授予每用户状态策略。
语法
Grant-CsPresencePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
状态信息非常重要，其中的一方面是，状态信息可让您知道联系人是否有空参与即时消息对话。但同时，状态信息也存在一定的相关成本：您具有的状态订阅越多，更新状态信息所需的网络带宽也就越大。如果网络带宽是需要考虑的一项因素，您可能想要限制任一用户可拥有的状态订阅数量。
CsPresencePolicy cmdlet 用于管理状态订阅的两个重要方面：提示订阅者和类别订阅。在将您添加到其他用户的 Microsoft Lync 2010 联系人列表中时，默认情况下，您会收到一条弹出式通知，告知您已被添加到该列表中。在消除弹出式通知之前，每条通知都将视为一个提示订阅者。状态策略的 MaxPromptedSubscriber 属性用于指定用户可以拥有的未处理通知对话框的最大数量。（如果用户达到最大数量，则在至少已处理其中一些对话框之前，将不会收到新的联系人通知。）
类别订阅表示对特定类别信息的请求，例如，请求日历数据的应用程序。通过 MaxCategorySubscription 属性，管理员可以对用户能拥有的类别订阅数量进行限制。
在 Microsoft Lync Server 2010 版本之前，提示订阅者和类别订阅以全局形式进行管理。现在，通过 CsPresencePolicy cmdlet，可以在 global 作用域、site 作用域或每用户作用域来管理这些状态订阅。这样，您就可以控制带宽使用，同时确保用户有权访问执行其作业所需的状态信息。
创建每用户策略时，该策略不会自动分配给任何人。必须通过运行 Grant-CsPresencePolicy cmdlet，将每用户状态策略显式分配给用户（或用户组）。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Grant-CsPresencePolicy cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsPresencePolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
指示要分配状态策略的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。还可以使用用户的 Active Directory 可分辨名称指定用户标识。 此外，在使用显示名称作为用户标识时，还可以使用通配符星号 (*)。例如，Identity "* Smith" 将返回显示名称以字符串值“Smith”结尾的所有用户。 |
|
PolicyName |
必需 |
要分配的每用户策略的标识，例如：-PolicyName "RedmondPresencePolicy"。PolicyName 就是策略 Identity 减去“tag:”前缀。例如，Identity 为“tag:NorthAmericaPresencePolicy”的策略的 PolicyName 等于“NorthAmericaPresencePolicy”。 |
|
DomainController |
可选 |
分配策略时要联系的域控制器的完全限定名称 (FQDN)。例如：-DomainController atl-dc-001.litwareinc.com。 如果未指定，Grant-CsPresencePolicy 将在分配策略时联系最近的可用域控制器。 |
|
PassThru |
可选 |
用于通过管道传递用户对象，该用户对象表示要分配策略的用户。默认情况下，此 Grant-CsPresencePolicy cmdlet 不通过管道传递对象。 |
|
WhatIf |
可选 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
|
Confirm |
可选 |
在执行命令之前提示您进行确认。 |
输入类型
字符串值或 Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy 对象。Grant-CsPresencePolicy 接受通过管道传递的代表用户帐户 Identity 的字符串值的输入。该 cmdlet 还接受通过管道传递的用户对象的输入。
返回类型
默认情况下，Grant-CsPresencePolicy 不会返回对象或值。但是，如果包含 PassThru 参数，则此 cmdlet 将返回 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 的实例。
示例
-------------------------- 示例 1 --------------------------
Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"
示例 1 中显示的命令将每用户状态策略 RedmondPresencePolicy 分配给单个用户：Identity 为 Ken Myer 的用户。
-------------------------- 示例 2 --------------------------
Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"
在示例 2 中，将为在 Active Directory 域服务 (AD DS) 的 Redmond OU 中拥有帐户的所有用户分配状态策略 RedmondPresencePolicy。为执行此操作，该命令首先使用 Get-CsUser 和 OU 参数返回 Redmond OU (OU=Redmond,dc=litwareinc,dc=com) 中发现的所有用户帐户的集合。然后，将该集合通过管道传递到 Grant-CsPresencePolicy，后者会为集合中的每个用户分配 RedmondPresencePolicy 策略。
-------------------------- 示例 3 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"
上述命令将策略 RedmondPresencePolicy 分配给在 Redmond 市工作的所有用户。为了执行此任务，该命令首先使用 Get-CsUser 和 LDAPFilter 参数返回在 Redmond 工作的所有用户的集合；筛选器值“l=Redmond”将返回的数据限制为来自 Redmond 的用户。（在 LDAP 查询语言中，l（即小写字母 L）是“locality”的简写形式。）然后，将检索到的集合通过管道传递到 Grant-CsPresencePolicy，后者会为集合中的每个用户分配 RedmondPresencePolicy 策略。
-------------------------- 示例 4 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null
示例 4 中显示的命令取消分配先前分配给在 Redmond 工作的用户的任何每用户状态策略。在将 PolicyName 参数设置为空值 ($Null) 的情况下调用 Grant-CsPresencePolicy 将导致该 cmdlet 删除已分配给受该命令影响的用户的所有每用户状态策略。