Grant-CsClientVersionPolicy
上一次修改主题： 2012-03-23
在 global、site、service 或每用户作用域分配客户端版本策略。通过客户端版本策略，您可以指定能够登录到 Microsoft Lync Server 2010 系统的客户端（如 Microsoft Office Communicator 2007 R2）。
语法
Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
客户端版本策略代表客户端版本规则的集合，而客户端版本规则用于确定允许登录到 Lync Server 2010 的客户端应用程序。用户尝试登录到 Lync Server 2010 时，其客户端应用程序会向该服务器发送 SIP 标头，此标头包括有关应用程序自身的详细信息（包括软件的主版本号、次版本号和内部版本号）。然后，对照客户端版本规则集合检查包含在 SIP 标头中的版本信息，以查看是否存在适用于该特定应用程序的规则。如果存在此类规则，则 Lync Server 2010 将执行该规则指定的操作。例如，该规则可能指示 Lync Server 2010 允许登录，也可能指示其阻止登录，或可能指示其允许登录，但之后以静默方式将客户端应用程序更新到最新版本（例如从 Office Communicator 2007 R2 更新到 Microsoft Lync 2010）。
客户端版本策略可应用于 global 作用域、site 作用域、service 作用域（仅限 Registrar 服务）或每用户作用域，使您能灵活地确定可用于访问系统的客户端应用程序。例如，您可能要阻止用户使用 Communicator 2007 R2 登录到 Lync Server 2010，因为此旧版客户端应用程序不支持与 Lync 2010 相同的功能。但是，由于硬件或软件冲突，您可能也选择了一组无法升级到 Lync 2010 的用户。在这种情况下，您可以创建一个单独的规则（和一个单独的客户端版本策略），以允许这些用户从 Communicator 2007 R2 中登录。
通过 Grant-CsClientVersionPolicy cmdlet，您可以为个别用户分配客户端版本策略。创建每用户策略时，该策略不能自动分配给任何人；只有调用 Grant-CsClientVersionPolicy 将该策略明确分配给用户或用户集，才能执行分配操作。
务必注意，客户端版本策略不适用于联盟用户，联盟用户应遵守其组织中使用的客户端版本策略。例如，假设一个联盟用户使用客户端 A（即联盟组织允许使用的客户端）。只要联盟组织允许使用客户端 A，该用户即可使用该客户端与您的组织通信。即使您的客户端版本策略阻止使用客户端 A 也是如此。您组织中强制执行的客户端版本策略并不会覆盖联盟组织中使用的客户端版本策略。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Grant-CsClientVersionPolicy cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsClientVersionPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户 ID 参数 |
指示应向其分配策略的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：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:RedmondClientVersionPolicy 的策略的 PolicyName 等于 RedmondClientVersionPolicy。要取消分配以前分配给用户的每用户策略，请将 PolicyName 设置为空值 ($null)。 |
DomainController |
可选 |
字符串 |
用于指定在分配策略时要连接到的域控制器。如果未包括此参数，则该 cmdlet 将使用第一个可用的域控制器。 |
PassThru |
可选 |
开关参数 |
如果存在此参数，将会导致该 cmdlet 通过 Windows PowerShell 管道传递用户对象。默认情况下，Grant-CsClientVersionPolicy 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Grant-CsClientVersionPolicy 接受通过管道传递的字符串值的输入，代表用户帐户的标识。该 cmdlet 还接受通过管道传递的用户对象的输入。
返回类型
默认情况下，Grant-CsClientVersionPolicy 不会返回对象或值。但是，如果包含 PassThru 参数，该 cmdlet 将返回 Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"
在示例 1 中，将客户端版本策略 RedmondClientVersionPolicy 分配给用户 Ken Myer。
-------------------------- 示例 2 --------------------------
Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"
示例 2 中显示的命令向所有在雷蒙德市工作的用户分配客户端版本策略 RedmondClientVersionPolicy。为执行此操作，该命令首先使用 Get-CsUser 和 LdapFilter 参数检索相应的用户帐户集合，筛选器值“l=Redmond”（其中，“l”是 L 的小写字母，即“locality”的 LDAP 属性名称）将检索到的数据限制为在 Redmond 市工作的用户。然后，将此集合通过管道传递到 Grant-CsClientVersionPolicy，后者将为集合中的每一个用户分配指定的策略。
-------------------------- 示例 3 --------------------------
Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"
在示例 3 中，将客户端版本策略 RedmondClientVersionPolicy 分配给特定组织单位 (OU) 中的所有用户。为完成此任务，该命令首先调用 Get-CsUser 和 OU 参数，参数值代表将为其中的用户分配客户端版本策略的 OU 的可分辨名称 (ou=Redmond,ou=North America,dc=litwareinc,dc=com)。检索用户帐户完成后，将此集合通过管道传递到 Grant-CsClientVersionPolicy，后者将向其中的每一个用户分配 RedmondClientVersionPolicy。
-------------------------- 示例 4 --------------------------
Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"
上述命令将客户端版本策略 RedmondClientVersionPolicy 分配给所有已为其分配语音策略 RedmondVoicePolicy 的用户。为执行此操作，该命令首先调用带有 Filter 参数的 Get-CsUser，筛选器值 {VoicePolicy -eq "RedmondVoicePolicy"} 可确保仅返回 VoicePolicy 属性等于“RedmondVoicePolicy”的用户帐户。然后，将返回的用户帐户通过管道传递到 Grant-CsClientVersionPolicy，并向这些用户帐户分配客户端版本策略 RedmondClientVersionPolicy。
-------------------------- 示例 5 --------------------------
Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null
在示例 5 中，将取消分配先前分配给组织中所有用户的任何每用户客户端版本策略。为执行此操作，该命令首先使用 Get-CsUser 返回组织中已启用 Lync Server 的所有用户的集合。然后，将该集合通过管道传递到 Remove-CsClientVersionPolicy，后者会删除分配给这些用户的任何每用户客户端版本策略。这是通过将 PolicyName 的参数值设置为 $null 实现的。