Get-CsClientVersionConfiguration
上一次修改主题： 2012-03-23
检索有关组织中所用客户端版本配置设置的指定集合的信息。客户端版本配置设置确定 Microsoft Lync Server 2010 是否将检查登录到系统的每个客户端应用程序的版本号。 如果已启用客户端版本筛选功能，则该客户端应用程序能否访问系统将基于相关客户端版本策略中配置的设置。
语法
Get-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsClientVersionConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
当管理员在指定用户可用于登录到系统的客户端软件（该软件的版本号同样重要）时，Lync Server 2010 可使管理员有较大的选择余地。例如，不存在技术原因要求用户使用 Microsoft Lync 2010 登录到 Lync Server 2010；没有技术限制可阻止用户使用 Microsoft Office Communicator 2007 R2 进行登录。
但是，可能存在一些非技术性原因，使您更希望用户不使用 Office Communicator 2007 R2 进行登录。例如，Office Communicator 2007 R2 并不支持 Lync 2010 中的所有功能；因此，使用 Office Communicator 2007 R2 登录的用户与使用 Lync 2010 登录的用户将具有不同的体验。这会给用户带来难题；对于必须为许多不同的客户端应用程序提供支持的技术支持人员来说，这也会是难题。
如果您的组织中可能存在此问题，可以使用客户端版本筛选功能，以指定可使用哪些客户端应用程序登录到 Lync Server 2010。在安装 Lync Server 2010 时，将会安装和启用一组全局客户端版本配置设置。这些设置用于确定是否启用客户端版本筛选功能。除了全局设置之外，客户端版本配置设置也可在 site 作用域应用；在这些情况中，站点设置将优先于全局设置。
通过 Get-CsClientVersionConfiguration cmdlet，可以检索有关组织中当前使用的客户端版本配置设置的信息。请注意，此 cmdlet 不会返回有关允许或不允许哪些客户端应用程序的信息。要检索该信息，请使用 Get-CsClientVersionPolicy。
请注意，客户端版本配置不是一种安全功能。该技术依赖于客户端应用程序的自我报告，它不会尝试验证一个应用程序是否确实是该应用程序，也不会尝试验证该应用程序的版本号是否与所声称的版本号相同。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsClientVersionConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientVersionConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
指示要返回的客户端版本配置设置集合的唯一标识符。要引用全局设置，请使用以下语法：-Identity global。要引用在 site 作用域配置的集合，请使用以下类似语法：-Identity site:Redmond。在指定 Identity 时不能使用通配符。如果需要使用通配符，请改用 Filter 参数。 如果未指定此参数，则 Get-CsClientVersionConfiguration 将返回组织中使用的所有客户端版本配置设置的集合。 |
Filter |
可选 |
字符串 |
使您可以使用通配符，以便返回一个或多个客户端版本配置设置集合。要返回在 site 作用域配置的所有设置的集合，请使用以下语法：-Filter site:*。要返回其 Identity（唯一可以筛选的属性）中某位置包含字符串值“EMEA”的所有设置的集合，请使用以下语法：-Filter *EMEA*。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索客户端版本配置数据。 |
输入类型
无。Get-CsClientVersionConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsClientVersionConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsClientVersionConfiguration
在第一个示例中，调用了 Get-CsClientVersionConfiguration，而未指定任何其他参数。这样，Get-CsClientVersionConfiguration 将会返回组织中当前使用的所有客户端版本配置设置的集合。
-------------------------- 示例 2 --------------------------
Get-CsClientVersionConfiguration -Identity site:Redmond
在上述示例中，Get-CsClientVersionConfiguration 返回 Identity 为 site:Redmond 的所有客户端版本配置设置。由于标识必须唯一，因此该命令绝不会返回多项。
-------------------------- 示例 3 --------------------------
Get-CsClientVersionConfiguration -Filter "site:*"
示例 3 返回在 site 作用域应用的所有客户端版本配置设置。这是通过包括 Filter 参数和筛选器值“site:*”实现的。该筛选器值指示 Get-CsClientVersionConfiguration 仅返回 Identity 以字符串值“site:”开头的设置。
-------------------------- 示例 4 --------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False}
上述示例返回当前已禁用的所有客户端版本配置设置。为了执行此任务，该命令首先使用 Get-CsClientVersionConfiguration 返回配置为在组织中使用的所有客户端版本设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会应用筛选器，将集合限制为 Enabled 属性等于 False 的设置。