Get-CsClientPolicy
上一次修改主题： 2012-03-23
返回有关配置为在组织中使用的客户端策略的信息。客户端策略的功能之一是有助于确定可提供给用户的 Microsoft Lync 2010 的功能；例如，可为一些用户授予传输文件的权利，而对其他用户拒绝授予这项权利。
语法
Get-CsClientPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsClientPolicy [-Filter <String>] [-LocalStore <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 策略一样）可轻松面向所选用户组。您甚至可以创建分配给单个用户的自定义策略。
可以在 global 作用域、site 作用域和每用户作用域配置客户端策略。Get-CsClientPolicy cmdlet 用于返回有关配置为在组织中使用的所有客户端策略的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsClientPolicy cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的客户端策略的唯一标识符。要引用全局策略，请使用以下语法：-Identity global。要引用站点策略，请使用类似如下的语法：-Identity site:Redmond。要引用每用户策略，请使用类似如下的语法：-Identity SalesDepartmentPolicy。 如果省略此参数，则会返回配置为在组织中使用的所有客户端策略。 |
Filter |
可选 |
字符串 |
使您可以在指示要返回的策略时使用通配符。例如，要返回在 site 作用域配置的所有策略，请使用以下语法：-Filter "site:*"。要返回所有每用户策略的集合，请使用以下语法：-Filter "tag:*"。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是中央管理存储本身检索客户端策略数据。 |
输入类型
无。Get-CsClientPolicy 不接受通过管道传递的输入。
返回类型
Get-CsClientPolicy 返回 Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsClientPolicy
在上述示例中，调用不带任何其他参数的 Get-CsClientPolicy；这将返回配置为在组织中使用的所有客户端策略的集合。
-------------------------- 示例 2 --------------------------
Get-CsClientPolicy -Identity SalesPolicy
在示例 2 中，使用 Get-CsClientPolicy 返回 Identity 为 SalesPolicy 的每用户客户端策略。由于标识是唯一的，因此该命令绝不会返回多项。
-------------------------- 示例 3 --------------------------
Get-CsClientPolicy -Filter "tag:*"
示例 3 使用 Filter 参数返回在每用户作用域配置的所有客户端策略。筛选器值“tag:*”指示 Get-CsClientPolicy 仅返回 Identity 以字符串值“tag:”开头的策略。
-------------------------- 示例 4 --------------------------
Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}
上述命令返回 DisableSavingIM 属性为 True 的所有客户端策略的集合。为执行此操作，首先调用了不带任何参数的 Get-CsClientPolicy，以返回配置为在组织中使用的所有客户端策略的集合。然后，将此集合通过管道传递到 Where-Object cmdlet，该 cmdlet 将仅选择 DisableSavingIM 属性等于 True 的策略。
-------------------------- 示例 5 --------------------------
Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}
在示例 5 中，仅返回满足以下两个条件的客户端策略：DisableSavingIM 属性必须为 True，EnableIMAutoArchiving 属性必须为 False。为执行此操作，该命令首先调用 Get-CsClientPolicy，以返回配置为在组织中使用的所有客户端策略的集合。然后，将该集合通过管道传递到 Where-Object，后者会仅挑选满足以下两个条件的策略：DisableSavingIM 必须等于 True，EnableIMAutoArchiving 必须等于 False。运算符 -and 向 Where-Object 说明，应仅选择满足所有指定条件的对象。
-------------------------- 示例 6 --------------------------
Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}
示例 6 是示例 5 中显示的命令的变体。但在此示例中，只要策略至少满足以下条件之一就将被选中：DisableSavingIM 属性为 True 和/或 EnableIMAutoArchiving 属性为 False。为了完成此任务，该命令首先调用 Get-CsClientPolicy 返回配置为在组织中使用的所有客户端策略的集合。然后，将该集合通过管道传递到 Where-Object，后者会仅挑选至少满足以下条件之一的策略：DisableSavingIM 等于 True 和/或 EnableIMAutoArchiving 等于 False。运算符 -or 向 Where-Object 说明，应仅选择至少满足所指定条件之一的任何对象。