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 指令程式所建立。一旦建立之後，日後可藉由執行 Remove-CsTestDevice 指令程式來移除裝置。請注意，若將裝置當成測試裝置移除，實際裝置本身並不會受到影響；例如，您的 Lync 2010 Phone Edition 手機仍可以用來存取 Lync Server 2010。唯一的差別就是，因為裝置不再是測試裝置，所以它將不再下載處於擱置狀態的裝置更新規則，而是會等到規則獲准後，才下載並安裝這些規則。
Remove-CsTestDevice 可以用來移除在通用或站台範圍設定的個別測試裝置。您也可以使用此指令程式來移除所有針對特定範圍設定的測試裝置。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsTestDevice Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTestDevice"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
表示要移除之測試裝置的 Identity。若要移除特定裝置，請同時加上範圍 (例如 site:Redmond) 和裝置名稱，例如：-Identity "site:Redmond/UCPhoneTest"。若要從特定站台移除所有裝置，請使用如下的語法：-Identity "site:Redmond"。 您也可以從全域範圍中移除測試裝置。無法移除通用測試裝置集合本身；但下列命令會刪除已儲存在通用集合中的所有裝置： Remove-CsTestDevice –Identity global |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice 物件。Remove-CsTestDevice 接受測試裝置物件管線傳送的輸入。
傳回類型
Remove-CsTestDevice 不會傳回值或物件。而是指令程式會設定 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 中，會移除所有已在站台範圍設定的測試裝置。為了執行此作業，會使用 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 指令程式，其會使用 -match 運算子來傳回任何在 Name 內容中出現字串值 "LG-Nortel" 的裝置。然後，會使用 Remove-CsTestDevice 來刪除任何符合該準則的測試裝置。