Set-CsClientVersionConfiguration
上一次修改主题： 2012-03-27
修改指定的客户端版本配置设置的集合。客户端版本配置设置确定 Microsoft Lync Server 2010 是否将检查登录到系统的每个客户端应用程序的版本号。 如果已启用客户端版本筛选功能，则该客户端应用程序能否访问系统将基于相应客户端版本策略中配置的设置。
语法
Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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 作用域应用；在这些情况中，站点设置将优先于全局设置。
通过 Set-CsClientVersionConfiguration cmdlet，可以修改客户端版本配置设置的现有集合。
请注意，客户端版本配置不是安全功能。该技术依赖于客户端应用程序的自我报告，它不会尝试验证一个应用程序是否确实是该应用程序，也不会尝试验证该应用程序的版本号是否与所声称的版本号相同。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsClientVersionConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientVersionConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
表示要修改的客户端版本配置设置的唯一标识符。要修改全局设置，请使用此类语法：-Identity global。要修改分配到站点作用域的设置，请使用类似语法："site:Redmond"。 如果不包括此参数，Set-CsClientVersionConfiguration 将自动配置全局设置。 |
Instance |
可选 |
客户端版本策略对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
DefaultAction |
可选 |
字符串 |
指示当用户尝试从在相应客户端版本策略中未找到其版本号的客户端应用程序登录时要采取的操作。DefaultAction 必须设置为下列值之一： Allow。允许客户端应用程序登录。 AllowWithUrl。允许客户端应用程序登录。此外，还会向用户显示一个消息框，其中包括一个网页的 URL，用户可以在该网页中下载已批准的客户端应用程序。应将该网页的 URL 指定为 DefaultUrl 属性的值。 Block。阻止客户端应用程序登录。 BlockWithUrl。阻止客户端应用程序登录。但是，向用户显示的“访问被拒绝”消息框将包括一个网页的 URL，用户可以在该网页中下载已批准的客户端应用程序。应将该网页的 URL 指定为 DefaultUrl 属性的值。 如果 Enabled 属性设置为 False，则忽略此属性。当 Enabled 属性设置为 False 时，将不会进行任何类型的客户端版本筛选。 |
DefaultUrl |
可选 |
字符串 |
指定用户可在其中下载已批准客户端应用程序的网页的 URL。如果指定了该 URL，并且将 DefaultAction 设置为 BlockWithURL，则无论何时用户尝试使用不受支持的客户端应用程序进行登录，此 URL 都会出现在“访问被拒绝”消息框中。 |
Enabled |
可选 |
布尔值 |
表示是启用还是禁用客户端版本筛选。如果 Enabled 属性为 True，则服务器将对每个尝试登录的客户端应用程序进行版本号检查；然后，服务器将允许或拒绝访问，具体取决于相应的客户端版本号策略。如果 Enabled 属性设置为 False，则将允许能够登录的任何客户端应用程序进行登录。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
布尔值 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 对象。Set-CsClientVersionConfiguration 接受通过管道传递的客户端版本配置对象的实例。
返回类型
Set-CsClientVersionConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False
在示例 1 中，Set-CsClientVersionConfiguration 用于修改 Identity 为“site:Redmond”的设置集合。在此情况下，Enabled 参数设置为 False 以禁用客户端版本配置设置。
-------------------------- 示例 2 --------------------------
Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"
在上述示例中，修改了组织中当前正在使用的所有客户端版本配置设置的 DefaultUrl 属性。为执行此操作，命令首先会调用不带任何其他参数的 Get-CsClientVersionConfiguration，以返回所有客户端版本配置设置。然后，将该信息通过管道传递到 Set-CsClientVersionConfiguration，从而将每个配置集合的 DefaultUrl 值设置为 https://litwareinc.com/csclients。
-------------------------- 示例 3 --------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"
在示例 3 中，对 DefaultAction 当前设置为 Block 的所有客户端版本配置设置进行了修改。为完成此任务，该命令首先使用 Get-CsClientVersionConfiguration 返回当前使用的所有客户端版本配置设置。然后，将该信息通过管道传递到 Where-Object cmdlet，后者会仅挑选 DefaultAction 属性等于“Block”的项目。反过来，将筛选出的集合通过管道传递到 Set-CsClientVersionConfiguration，后者将对集合中的每个项执行两种操作：1) 将 DefaultAction 设置为 BlockWithUrl；和 2) 将 DefaultUrl 设置为 https://litwareinc.com/csclients。