Remove-CsDeviceUpdateRule
上次修改主題的時間： 2012-03-25
移除設定為在組織中使用的裝置更新規則。裝置更新規則可用來讓韌體更新與執行 Microsoft Lync 2010 Phone Edition 的裝置產生關聯。
語法
Remove-CsDeviceUpdateRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 使用裝置更新規則來提供韌體更新給執行 Lync 2010 Phone Edition 的裝置。系統管理員會定期將一組裝置更新規則上傳到 Lync Server 2010；那些規則經過測試與核准後，裝置與系統連線時會自動下載那些規則並套用到裝置。根據預設，裝置每次開啟並連線到 Lync Server 時，都會檢查新的更新規則。在最初登入之後，裝置每隔 24 小時也會檢查一次更新。
系統管理員無法建立他們自己的裝置更新規則；更新規則只能透過下載及匯入來自 Microsoft 網站的規則集而建立。也就是說，隨著時間推移，您很可能收集了已過期或組織中不再使用的規則 (例如，如果您的組織不再使用 LG-Nortel 電話，就不再需要那些裝置的韌體更新)。雖然這些不需要的規則不會造成任何問題，但是會使管理變得複雜：執行 Get-CsDeviceUpdateRule Cmdlet 以傳回所有裝置更新規則的集合時，卻發現大多數規則不適用於您組織，這是很令人困擾的。為了協助減少這樣的困擾，可以使用 Remove-CsDeviceUpdateRule 來移除已匯入供使用的所有裝置更新規則 (或規則集)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsDeviceUpdateRule Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDeviceUpdateRule"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
裝置更新規則的唯一識別碼。裝置更新規則的 Identity 包含兩個部分：已套用規則的服務範圍 (例如 service:WebServer:atl-cs-001.litwareinc.com) 和預先指派給規則的全域唯一識別碼 (GUID) (例如 d5ce3c10-2588-420a-82ac-dc2d9b1222ff9)。在此基礎上，指定裝置更新規則的 Identity 的外觀類似如下："service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 "。 指定 Identity 時不允許使用萬元字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 物件。Remove-CsDeviceUpdateRule 接受管線傳送的裝置更新規則物件執行個體。
傳回類型
Remove-CsDeviceUpdateRule 不會傳回值或物件，反之，指令程式會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9
以上的命令會刪除 Identity 為 service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 的裝置更新規則。刪除規則之後，將無法再使用對應的韌體更新。
-------------------------- 範例 2 ------------------------
Get-CsDeviceUpdateRule | Remove-CsDeviceUpdateRule
範例 2 所示的命令會移除已設為在組織中使用的所有裝置更新規則。這可以透過呼叫 Get-CsDeviceUpdateRule (不含任何參數)，以傳回目前在使用中之所有裝置更新規則的集合來完成。接著，該集合會傳送到 Remove-CsDeviceUpdateRule，這會刪除集合中的每一個規則。
-------------------------- 範例 3 ------------------------
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Remove-CsDeviceUpdateRule
在範例 3 中，會移除已匯入服務 WebServer:atl-cs-001.litwareinc.com 的所有裝置更新規則。若要這樣做，此命令會先使用 Get-CsDeviceUpdateRule 和 Filter 參數來擷取 Identity 開頭為字串值 "service:WebServer:atl-cs-001.litwareinc.com " 的所有裝置更新規則。接下來，此集合會傳送到 Remove-CsDeviceUpdateRule，以刪除該集合中的每一個規則。
-------------------------- 範例 4 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Remove-CsDeviceUpdateRule
以上的命令會刪除 Brand 等於 "LG-Nortel" 的所有裝置更新規則。為達成此目的，此指令程式會呼叫 Get-CsDeviceUpdateRule (不用任何參數)，以擷取組織中目前使用中之所有裝置更新規則的集合。接著，此集合會傳送到 Where-Object 指令程式，這樣會只選取 Brand 等於 "LG-Nortel" 的規則。然後，這個篩選過的集合會傳送到 Remove-CsDeviceUpdateRule，以移除集合中的每個規則。