Restore-CsDeviceUpdateRule
上一次修改主题： 2012-03-27
使您可以“回滚”已批准在组织中使用的设备更新规则。还原设备更新规则后，将重置该规则的已批准版本，以反映在规则得到批准之前所使用的更新。反之，登录系统的客户端设备将自动卸载最近的更新，然后下载并重新安装之前的更新版本。
语法
Restore-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Restore-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 使用设备更新规则为运行 Lync 2010 Phone Edition 的设备提供固件更新。管理员会定期将一组设备更新规则上载到 Lync Server 2010；这些规则经过测试和批准后，在下次相应的设备连接到系统时，将自动下载并应用到这些设备。默认情况下，设备会在每次打开并连接到 Lync Server 时检查是否存在新的更新规则；设备还会在初始登录后每 24 小时检查一次更新。
添加到系统的每个新设备更新规则均标为“待处理”。这意味着相应的测试设备将下载并安装更新；但是，通常不是由客户端设备下载并安装更新。这能让您选择测试更新，并在广泛应用这些更新前确保没有不利影响。一旦确认更新已通过测试并可在组织中使用，则可以使用 Approve-CsDeviceUpdateRule 批准该更新。
批准更新后，会将相关更新规则的 PendingVersion 分配到 ApprovedVersion，然后清除 PendingVersion 属性。例如，假如新更新规则的 PendingVersion 是版本 1.0.0.1。运行 Approve-CsDeviceUpdateRule 后，PendingVersion 将设置为空值，ApprovedVersion 将设置为 1.0.0.1。下次客户端设备检查更新时，会自动下载和安装更新。
此外，先前的更新版本（例如，版本 1.0.0.0）将标记为 RestoreVersion。此更新版本将保留在系统中，在需要回滚新的更新时将使用此更新版本。如果突然出现问题，管理员可以使用 Restore-CsDeviceUpdateRule cmdlet 回滚更新。发生这种情况后，客户端设备会在下次检查更新时自动卸载新的更新（版本 1.0.0.1）并重新安装先前的更新 (1.0.0.0)。
请注意，这种情况只有在有先前的更新可供安装时才会发生。如果没有以前版本，则回滚的更新只会被卸载。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Restore-CsDeviceUpdateRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Restore-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 对象。Restore-CsDeviceUpdateRule 接受通过管道传递的设备更新规则对象的实例。
返回类型
无。Restore-CsDeviceUpdateRule 会恢复 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Restore-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* | Restore-CsDeviceUpdateRule
上述命令可恢复为 WebServer:atl-cs-001.litwareinc.com 服务配置的所有设备更新规则。要执行此操作，命令首先调用 Get-CsDeviceUpdateRule 和 Filter 参数，过滤值“WebServer:atl-cs-001.litwareinc.com*”确保仅返回 Identity 以字符串值“WebServer:atl-cs-001.litwareinc.com”开头的规则（根据定义，这些规则是已分配给服务 WebServer:atl-cs-001.litwareinc.com 的所有设备更新规则）。然后，将筛选出的集合通过管道传递给 Restore-CsDeviceUpdateRule cmdlet，后者将恢复集合中的每个规则。
-------------------------- 示例 3 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Restore-CsDeviceUpdateRule
示例 3 显示如何恢复指定 Brand (LG-Nortel) 的所有设备更新规则。为此，该命令首先调用 Get-CsDeviceUpdateRule（无任何其他参数）返回组织中当前正在使用的所有设备更新规则的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅选取 Brand 属性等于 LG-Nortel 的规则。接下来，将筛选出的集合通过管道传递到 Restore-CsDeviceUpdateRule，以恢复已筛选集合中的所有规则。