Reset-CsDeviceUpdateRule
上一次修改主题： 2012-03-25
拒绝已导入系统的设备更新规则。
语法
Reset-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Reset-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 批准该更新。
另一方面，管理员可能会得出结论，认为不应在组织中使用给定更新（例如，更新可能导致与内部软件产生冲突）。在这种情况下，管理员可使用 Reset-CsDeviceUpdateRule cmdlet 拒绝该更新。发生这种情况时，更新规则的 PendingVersion 将设置为 null 值。接下来，这意味着登录系统的测试设备将卸载该更新，并重新安装该更新的已批准版本。并且由于从未批准该更新，因此这意味着除测试设备以外，其他任何设备均不会安装该更新。所以不会对一般用户群体造成任何影响。
Reset-CsDeviceUpdateRule cmdlet 只能用于“待处理”状态下的设备更新规则。如果已批准规则，则需要使用 Restore-CsDeviceUpdateRule cmdlet 回滚设备更新的部署。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Reset-CsDeviceUpdateRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Reset-CsDeviceUpdateRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要重置的设备更新规则的唯一标识符。设备更新规则的 Identity 由以下两个部分组成：分配设备更新规则的服务（例如，service:WebServer:atl-cs-001.litwareinc.com）和全局唯一标识符 (GUID)。因此，为 Redmond 站点配置的设备更新规则的 Identity 将类似于："service:WebServer:atl-cs-oo1.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9". |
Instance |
可选 |
DeviceUpdate.Rule |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Force |
可选 |
开关参数 |
禁止显示运行此 cmdlet 时可能出现的任何确认提示或非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 对象。Reset-CsDeviceUpdateRule 接受通过管道传递的设备更新规则对象的实例。
返回类型
无。Reset-CsDeviceUpdateRule 会重置 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Reset-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* | Reset-CsDeviceUpdateRule
上述命令重置已为服务 WebServer:atl-cs-001.litwareinc.com 配置的所有设备更新规则。为此，首先调用带有 Filter 参数的 Get-CsDeviceUpdateRule；筛选器值“WebServer:atl-cs-001.litwareinc.com*”确保仅返回 Identity 以“WebServer:atl-cs-001.litwareinc.com”这些字符开头的规则。（根据定义，这些规则是已分配给服务 WebServer:atl-cs-001.litwareinc.com 的所有设备更新规则）。然后，将筛选出的集合通过管道传递给 Reset-CsDeviceUpdateRule cmdlet，后者重置集合中的每个规则。
-------------------------- 示例 3 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Reset-CsDeviceUpdateRule
示例 3 中显示的命令重置品牌 LG-Nortel 的所有设备更新规则。为此，该命令首先调用 Get-CsDeviceUpdateRule（无任何其他参数）返回组织中当前正在使用的所有设备更新规则的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅选取 Brand 属性等于 LG-Nortel 的规则。然后，将筛选出的集合通过管道传递给 Reset-CsDeviceUpdateRule，后者将重置筛选出的集合中的所有规则。