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 指令程式來拒絕更新。當此情況發生時，更新規則的 PendingVersion 會設為 Null 值。然後，這表示登入系統的測試裝置將會解除安裝更新，並重新安裝該更新的核准版本。因為更新從未經由核准，這表示除了這些測試裝置，其他裝置絕對不會安裝更新。因此，不會影響一般使用者族群。
Reset-CsDeviceUpdateRule 指令程式只能用於「擱置」狀態中的裝置更新規則。如果某個規則已經過核准，您將必須使用 Restore-CsDeviceUpdateRule 指令程式回復裝置更新的部署。
誰可以執行此 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 設定的所有裝置更新規則。首先呼叫 Get-CsDeviceUpdateRule 並搭配 Filter 參數，即可完成此工作；篩選值 "WebServer:atl-cs-001.litwareinc.com*" 確保只傳回 Identity 開頭字元為 "WebServer:atl-cs-001.litwareinc.com" 的規則。(根據定義，這些是已指派給服務 WebServer:atl-cs-001.litwareinc.com 的所有裝置更新規則)。接著，篩選過的集合會傳送到 Reset-CsDeviceUpdateRule 指令程式，以重設集合中的每個規則。
-------------------------- 範例 3 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Reset-CsDeviceUpdateRule
範例 3 所示的命令會重設品牌 LG-Nortel 的所有裝置更新規則。若要這樣做，此命令會先呼叫 Get-CsDeviceUpdateRule 且不搭配任何參數，以傳回目前用於組織之所有裝置更新規則的集合。接著將這個集合傳送到 Where-Object 指令程式；這只會挑選 Brand 屬性等於 LG-Nortel 的規則。之後，篩選過的集合會傳送到 Reset-CsDeviceUpdateRule，以繼續重設篩選過的集合中的所有規則。