Remove-CsDeviceUpdateConfiguration
上一次修改主题： 2012-03-27
删除指定的设备更新配置设置。这些设置可帮助管理设备更新 Web 服务，即 Microsoft Lync Server 2010 组件，该组件使管理员可以向电话和其他运行 Microsoft Lync 2010 Phone Edition 的设备分发固件更新。
语法
Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
设备更新 Web 服务为管理员提供了一种方法，用于向运行 Lync 2010 Phone Edition 的设备分发固件更新。管理员可定期将一组设备更新规则上载到 Lync Server 2010。测试和批准这些规则后，在相应的设备连接到系统时，会将规则应用于这些设备。设备将在首次打开时检查更新，然后在用户登录时重新检查。此后，设备还将每隔 24 小时检查一次更新。
Lync Server 使用设备更新配置设置管理设备更新 Web 服务；可在 global 作用域或 site 作用域应用这些配置设置。默认情况下，只能在 global 作用域找到这些设置；但是，也可使用 New-CsDeviceUpdateConfiguration cmdlet 在 site 作用域分配自定义设置。
此外，还可以使用 Remove-CsDeviceUpdateConfiguration cmdlet 删除已在 site 作用域分配的设置。在针对站点运行此 cmdlet 时，将删除分配给该站点的设备更新配置设置。您也可以针对全局设置运行 Remove-CsDeviceUpdateConfiguration。但是在这种情况下，将不会删除全局设置；因为您无法删除全局设备更新配置设置。全局属性将重置为其默认值。例如，假设您已将全局属性 MaxLogCacheLimit 更改为 1,024,000 个字节。如果针对全局设置运行 Remove-CsDeviceUpdateConfiguration，将不会删除这些全局设置；但是，任何已修改的属性都将重置为其默认值。这意味着 MaxLogCacheLimit 将重置为 512,000 个字节。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsDeviceUpdateConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDeviceUpdateConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
指示要删除的设备更新配置设置的标识。要引用全局设置，请使用以下语法：-Identity global。要引用站点设置，请使用以下类似语法：-Identity site:Redmond。请注意，在指定 Identity 时不能使用通配符。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration 对象。Remove-CsDeviceUpdateConfiguration 接受通过管道传递的设备更新配置对象的实例。
返回类型
无。Remove-CsDeviceUpdateConfiguration cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsDeviceUpdateConfiguration -Identity global
在示例 1 中，Remove-CsDeviceUpdateConfiguration 用于“删除”全局设备更新配置设置。由于无法实际删除全局设置，因此该命令不会删除任何内容；但是，全局设备更新配置设置中的所有属性都将重置为其默认值。
-------------------------- 示例 2 --------------------------
Remove-CsDeviceUpdateConfiguration -Identity site:Redmond
上述命令删除 Identity 为 site:Redmond 的设备更新配置设置。由于这些设置是在站点范围配置的，因此将删除它们，并且 Redmond 站点将不再拥有其自己的一组设备更新配置设置。
-------------------------- 示例 3 --------------------------
Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration
在示例 3 中，将删除在 site 作用域配置的所有设备更新配置设置。为执行此操作，使用 Get-CsDeviceUpdateConfiguration cmdlet 和 Filter 参数返回 Identity 以字符串值“site:”开头的所有设置；根据定义，这些设置将全部是在 site 作用域配置的设置。然后，将该集合通过管道传递到 Remove-CsDeviceUpdateConfiguration cmdlet，后者会删除集合中的每一项。
-------------------------- 示例 4 --------------------------
Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000} | Remove-CsDeviceUpdateConfiguration
在示例 4 中，将删除 MaxLogFileSize 属性大于 1024000 个字节的所有设备更新配置设置。为了完成此任务，首先调用了 Get-CsDeviceUpdateConfiguration，以便返回所有设备更新配置设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 MaxLogFileSize 属性大于 1024000 个字节的配置设置。然后，将筛选出的集合通过管道传递到 Remove-CsDeviceUpdateConfiguration，后者会删除集合中的每一项。