Remove-CsTestDevice
上一次修改主题： 2012-03-27
删除指定的设备更新管理测试设备。测试设备为管理员提供了一种方法，用于在将固件更新分发到组织中的所有设备之前测试这些更新。
语法
Remove-CsTestDevice -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
通过将特定的兼容 Microsoft Lync 2010 Phone Edition 的电话或其他设备标识为测试设备，管理员可以验证和批准固件更新，然后向组织中的所有相关设备提供这些更新。将设备更新规则导入到 Microsoft Lync Server 2010 中时，这些规则将标记为“待处理”；这意味着受影响的设备不会自动下载并安装与这些规则相对应的更新。
这些待处理的规则将由任何相关测试设备进行下载和安装。测试设备的理念是：新设备更新规则将自动应用到测试设备，从而使管理员有机会验证固件更新是否会按预期工作。如果按预期工作，这些管理员可将规则标记为已批准，然后组织中的所有相关设备将下载并安装已批准的规则。
测试设备是运行 Lync 2010 Phone Edition 的硬件设备。使用 New-CsTestDevice cmdlet 创建这些设备。创建设备后，可在以后通过运行 Remove-CsTestDevice cmdlet 来删除这些设备。请注意，删除作为测试设备的设备不会影响实际设备自身；例如，您的 Lync 2010 Phone Edition 兼容电话仍可用于访问 Lync Server 2010。其唯一区别在于，由于设备不再是测试设备，因此，它将不再下载处于待处理状态的设备更新规则。设备会等到规则已获批准之后才下载和安装它们。
Remove-CsTestDevice 可用于删除在 global 作用域或 site 作用域配置的各个测试设备。此外，您还可以使用此 cmdlet 删除针对给定作用域配置的所有测试设备。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsTestDevice cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTestDevice"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
指示要删除的测试设备的标识。要删除特定设备，请同时包含作用域（例如 site:Redmond）和设备名称；例如：-Identity "site:Redmond/UCPhoneTest"。要删除特定站点中的所有设备，请使用以下类似语法：-Identity "site:Redmond"。 此外，还可以删除 global 作用域中的测试设备。无法删除全局测试设备集合本身，但是可使用以下命令删除存储在全局集合中的所有设备： Remove-CsTestDevice –Identity global |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice 对象。Remove-CsTestDevice 接受通过管道传递的测试设备对象的输入。
返回类型
Remove-CsTestDevice 不会返回值或对象。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsTestDevice -Identity site:Redmond
上述命令删除 Redmond 站点中的所有测试设备。这将删除设备集合以及各测试设备。
-------------------------- 示例 2 --------------------------
Get-CsTestDevice | Remove-CsTestDevice
示例 2 中显示的命令删除配置为在组织中使用的所有测试设备；该操作的实现方法是：使用 Get-CsTestDevice 返回所有测试设备集合，然后将所有项通过管道传递到 Remove-CsTestDevice。请注意，无法删除全局测试设备集合；但是，此命令将删除在全局级别配置的各个测试设备。
-------------------------- 示例 3 --------------------------
Get-CsTestDevice -Filter "site:" | Remove-CsTestDevice
在示例 3 中，将删除在 site 作用域配置的所有测试设备。为完成此任务，使用 Get-CsTestDevice 和 Filter 参数返回 Identity 以字符串值“site:”开头的所有测试设备。然后，将筛选出的集合通过管道传递到 Remove-CsTestDevice，后者会删除该集合中的所有项。
-------------------------- 示例 4 --------------------------
Get-CsTestDevice | Where-Object {$_.Name -match "LG-Nortel Phone"} | Remove-CsTestDevice
示例 4 中显示的命令删除所有 LG-Nortel 电话测试设备。为执行此操作，该命令首先调用 Get-CsTestDevice 返回配置为在组织中使用的所有测试设备。然后，将这些信息通过管道传递到 Where-Object cmdlet，后者会使用 -match 运算符返回在 Name 属性中的任意位置包含字符串值“LG-Nortel”的所有设备。然后，使用 Remove-CsTestDevice 删除符合该条件的任何测试设备。