Approve-CsDeviceUpdateRule
上一次修改主题： 2012-03-23
批准已导入系统的设备更新规则。批准设备更新规则后，受更新影响的客户端设备将自动下载并安装对应的更新。
语法
Approve-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Approve-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 使用设备更新规则为运行 Lync 2010 Phone Edition 的设备提供固件更新。管理员可定期将一组设备更新规则上载到 Lync Server 2010；在测试和批准这些规则之后，会自动下载这些规则并将其应用于相应的设备，例如与系统连接的设备。默认情况下，设备会在每次打开并连接到 Lync Server 2010 时检查是否存在新的更新规则。此外，设备还会在初始登录后每隔 24 小时检查一次更新。
添加到系统的每个新设备更新规则都将标记为“Pending”。这意味着，相应的测试设备将下载并安装该更新，但是，通常情况下，客户端设备不会下载并安装该更新。这样可以测试更新，并确保在更新投入广泛使用之前，没有负面影响。一旦确认更新已通过测试并可在组织中使用，则可以使用 Approve-CsDeviceUpdateRule 批准该更新。
批准更新时，会将相关更新规则的 PendingVersion 分配给 ApprovedVersion，然后清除 PendingVersion 属性。例如，假设新更新规则的 PendingVersion 是版本 1.0.0.1。运行 Approve-CsDeviceUpdateRule 后，PendingVersion 将设置为空值，ApprovedVersion 将设置为 1.0.0.1。下次客户端设备登录时，该设备将自动检查是否存在适用于该设备的新批准的更新。如果存在，将自动下载并安装该更新。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Approve-CsDeviceUpdateRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Approve-CsDeviceUpdateRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要批准的设备更新准则的唯一标识符。设备更新规则的 Identity 包括两部分：分配设备更新规则的服务（例如，service:WebServer:atl-cs-001.litwareinc.com）和全局唯一标识符 (GUID)。因此，为 Redmond 站点配置的设备更新规则的 Identity 将类似如下：service:WebServer:atl-cs-001.litwareinc.com /d5ce3c10-2588-420a-82ac-dc2d9b1222ff9。 |
Instance |
可选 |
DeviceUpdate.Rule 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 对象。Approve-CsDeviceUpdateRule 接受通过管道传递的设备更新规则对象的实例。
返回类型
无。Approve-CsDeviceUpdateRule 会批准 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Approve-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9
示例 1 中显示的命令批准服务 WebServer:atl-cs-001.litwareinc.com 中的设备更新规则 d5ce3c10-2588-420a-82ac-dc2d9b1222ff9。
-------------------------- 示例 2 --------------------------
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Approve-CsDeviceUpdateRule
上述命令批准为服务 WebServer:atl-cs-001.litwareinc.com 配置的所有设备更新规则。为执行此操作，命令首先调用带 Filter 参数的 Get-CsDeviceUpdateRule，过滤值“service:WebServer:atl-cs-001.litwareinc.com*”确保仅返回 Identity 以字符串值“service:WebServer:atl-cs-001.litwareinc.com”开头的规则（根据定义，这些是分配给服务 WebServer:atl-cs-001.litwareinc.com 的所有设备更新规则。）然后，将筛选出的集合通过管道传递到 Approve-CsDeviceUpdateRule cmdlet，后者将批准集合中的每个规则。
-------------------------- 示例 3 --------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Approve-CsDeviceUpdateRule
示例 3 中显示的命令批准指定品牌 (LG-Nortel) 的所有设备更新规则。为执行此操作，该命令首先调用 Get-CsDeviceUpdateRule 以返回组织中当前正在使用的所有设备更新规则的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅选取 Brand 属性等于 LG-Nortel 的规则。然后，将筛选出的集合通过管道传递到 Approve-CsDeviceUpdateRule，后者会批准集合中的每一条规则。