Grant-CsClientPolicy
上一次修改主题： 2012-03-23
向一个或一组用户分配客户端策略。客户端策略的功能之一是有助于确定可提供给用户的 Microsoft Lync 2010 的功能；例如，可为一些用户授予传输文件的权利，而对其他用户拒绝授予这项权利。
语法
Grant-CsClientPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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 策略一样）可轻松面向所选用户组。您甚至可以创建分配给单个用户的自定义策略。
可以在 global 作用域、site 作用域和每用户作用域配置客户端策略。要向用户分配每用户策略，必须使用 Grant-CsClientPolicy cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Grant-CsClientPolicy cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsClientPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
指示应向其分配策略的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。此外，还可以使用用户的 Active Directory 可分辨名称引用用户标识。 此外，在使用显示名称作为用户标识时，还可以使用通配符星号 (*)。例如，标识“* Smith”将返回显示名称以字符串值“Smith”结尾的所有用户。 |
PolicyName |
必需 |
字符串 |
要分配的策略的“名称”。PolicyName 就是策略 Identity 减去策略作用域（“tag:”）。例如，Identity 为 tag:Redmond 的策略的 PolicyName 为 Redmond；Identity 为 tag:RedmondConferencingPolicy 的策略的 PolicyName 为 RedmondConferencingPolicy。 如果将 PolicyName 设置为空值，则该命令将取消分配已分配给用户的任何每用户策略。例如： Grant-CsClientPolicy –Identity "Ken Myer" –PolicyName $Null |
DomainController |
可选 |
字符串 |
用于指定在分配策略时要连接到的域控制器。如果未包括此参数，则该 cmdlet 将使用第一个可用的域控制器。 |
PassThru |
可选 |
开关参数 |
如果存在此参数，将会导致该 cmdlet 通过 Windows PowerShell 管道传递用户对象。默认情况下，Grant-CsClientPolicy 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Grant-CsClientPolicy 接受通过管道传递的字符串值的输入，代表用户帐户的标识。该 cmdlet 还接受通过管道传递的用户对象的输入。
返回类型
默认情况下，Grant-CsClientPolicy 不会返回对象或值。但是，如果包含 PassThru 参数，该 cmdlet 将返回 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Grant-CsClientPolicy -Identity "Ken Myer" -PolicyName SalesPolicy
在上述示例中，将向 Identity 为 Ken Myer 的用户分配客户端策略 SalesPolicy。
-------------------------- 示例 2 --------------------------
Get-CsUser -LDAPFilter "Department=Sales" | Grant-CsClientPolicy -PolicyName SalesPolicy
在示例 2 中，将为属于销售部门的所有用户分配 SalesPolicy 客户端策略。该命令首先使用 Get-CsUser 和 LdapFilter 参数返回属于销售部门成员的所有用户的集合。然后，将该用户集合通过管道传递到 Grant-CsClientPolicy，后者会为集合中的每个用户分配策略 SalesPolicy。
-------------------------- 示例 3 --------------------------
Get-CsUser -LDAPFilter "(&(Title=Accountant)(l=Redmond))" | Grant-CsClientPolicy -PolicyName RedmondAccountingPolicy
在示例 3 中，将为满足以下两个条件的所有用户分配客户端策略 RedmondAccountingPolicy：1) 用户必须具有会计职务，2) 用户必须在 Redmond 市工作。为执行此操作，该命令首先使用 Get-CsUser 和 LdapFilter 参数，以返回在 Redmond 工作并且职务为会计的所有用户的集合。筛选器值“(&(Title=Accountant)(l=Redmond))”将返回的数据限制为职务为会计(Title=Accountant) 并且 (&) 在 Redmond (l=Redmond) 工作的用户。（“l”是 L 的小写字母，代表用户所在的县市。）
然后，将生成的集合通过管道传递到 Grant-CsClientPolicy，后者会为集合中的每个用户分配策略 RedmondAccountingPolicy。
-------------------------- 示例 4 --------------------------
Get-CsUser -LDAPFilter "(|(Title=Accountant)(Title=Senior Accountant))" | Grant-CsClientPolicy -PolicyName AccountingPolicy
上述命令将策略 AccountingPolicy 分配给满足以下两个条件之一的所有用户：用户的职务为会计或高级会计。为了执行此任务，使用 Get-CsUser 和 LdapFilter 参数返回职务为会计或高级会计的用户集合。筛选器值“(|(Title=Accountant)(Title=Senior Accountant))”将返回的数据限制为职务为会计 (Title=Accountant) 的用户或 (|) 职务为高级会计 (Title=Senior Accountant) 的用户。然后，将筛选出的集合通过管道传递到 Grant-CsClientPolicy，后者会为集合中的每个用户分配客户端策略 AccountingPolicy。
-------------------------- 示例 5 --------------------------
Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsClientPolicy -PolicyName AtlantaBranchPolicy
在示例 5 中，将为在注册器池 atl-cs-001.litwareinc.com 中具有帐户的所有用户分配客户端策略 AtlantaBranchPolicy。为执行此操作，首先调用 Get-CsUser 以返回相应的用户帐户；Filter 参数与筛选器值 {RegistrarPool -eq "atl-cs-001.litwareinc.com"} 可确保仅返回注册器池 atl-cs-001.litwareinc.com 中托管的用户帐户。然后，将该集合通过管道传递到 Grant-CsClientPolicy，后者会为每个用户分配客户端策略 AtlantaBranchPolicy。