Restore-CsDeviceUpdateRule
上次修改主題的時間： 2012-03-27
可讓您「回復」已核准供組織內使用的裝置更新規則。當您還原裝置更新規則時，會重設該規則的已核准版本，以反映規則核准之前在使用中的更新。然後，登入系統的用戶端裝置將會自動解除安裝最近的更新，再下載並重新安裝該更新的上一個版本。
語法
Restore-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Restore-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 來核准更新。
當您核准更新時，相關更新規則的 PendingVersion 會被指派給 ApprovedVersion，而且 PendingVersion 屬性會被清除。例如，假設新更新規則的 PendingVersion 是 1.0.0.1 版。在執行 Approve-CsDeviceUpdateRule 之後，系統會將 PendingVersion 設為 Null 值，並且會將 ApprovedVersion 設為 1.0.0.1。下次用戶端裝置檢查是否有更新時，將會自動下載並安裝更新。
除此之外，任何舊版的更新 (例如，1.0.0.0 版) 將會標示為 RestoreVersion。這一版的更新將會保留在系統上，而且如果新更新需要回復時，將會使用它。如果開始出現問題，系統管理員可以使用 Restore-CsDeviceUpdateRule 指令程式回復更新。發生該情況時，下次用戶端裝置檢查是否有更新時，裝置會自動解除安裝新的更新 (1.0.0.1 版)，並重新安裝上一版更新 (1.0.0.0)。
請注意，當然，只有要安裝上一版更新時才會發生這種情況。如果沒有上一版更新，則回復更新時便只是單純解除安裝。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Restore-CsDeviceUpdateRule Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Restore-CsDeviceUpdateRule"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
字串 |
要還原之裝置更新的唯一識別碼。裝置更新規則的 Identity 包含兩個部分：接受裝置更新規則指派的服務 (如 service:WebServer:atl-cs-001.litwareinc.com) 和全域唯一識別碼 (GUID)。因此，針對 Redmond 網站設定的裝置更新規則將擁有類似以下的 Identity：service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9。 |
Instance |
選用 |
DeviceUpdate.Rule 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 物件。Restore-CsDeviceUpdateRule 接受管線傳送的裝置更新規則物件執行個體。
傳回類型
無。而是 Restore-CsDeviceUpdateRule 會還原 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Restore-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* | Restore-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 的所有裝置更新規則)。接著將篩選過的集合傳送到 Restore-CsDeviceUpdateRule 指令程式，這會還原集合中的每一個規則。
-------------------------- 範例 3 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Restore-CsDeviceUpdateRule
範例 3 會示範如何還原指定品牌 (LG-Nortel) 的所有裝置更新規則。若要這樣做，此命令會先呼叫 Get-CsDeviceUpdateRule 且不搭配任何參數，以傳回目前用於組織之所有裝置更新規則的集合。接著將這個集合傳送到 Where-Object 指令程式；這只會挑選 Brand 屬性等於 LG-Nortel 的規則。然後，這個篩選過的集合會傳送到 Restore-CsDeviceUpdateRule，以還原篩選過之集合中的所有規則。