Approve-CsDeviceUpdateRule
上次修改主題的時間： 2012-03-23
核准已匯入系統的裝置更新規則。核准裝置更新規則後，受更新影響的用戶端裝置將會自動下載及安裝對應的更新。
語法
Approve-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Approve-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 使用裝置更新規則來提供韌體更新給執行 Lync 2010 Phone Edition 的裝置。系統管理員會定期將一組裝置更新規則上傳到 Lync Server 2010；那些規則經過測試與核准後，裝置與系統連線時會自動下載並套用到裝置。根據預設，每當裝置開啟並連接至 Lync Server 2010 時，都會檢查新的更新規則。在最初登入之後，裝置每隔 24 小時也會檢查一次更新。
系統會將每個新增至系統的新裝置更新規則標示為「擱置」。這代表適當的測試裝置將會下載指定的更新並安裝，不過負責下載及安裝的裝置通常不是用戶端裝置。您可以藉由這個機會測試更新，以在廣泛提供更新之前確保這項更新不會產生任何負面的影響。在您確信更新已通過測試且適用於您的組織之後，接著就可以使用 Approve-CsDeviceUpdateRule 來核准更新。
在核准更新時，系統會將相關更新規則的 PendingVersion 指派給 ApprovedVersion，也會清除 PendingVersion 屬性。例如，假設新更新規則的 PendingVersion 為 1.0.0.1 版。在執行 Approve-CsDeviceUpdateRule 之後，系統會將 PendingVersion 設為 Null 值，並且會將 ApprovedVersion 設為 1.0.0.1。等到下次用戶端裝置登入時，該裝置便會自動檢查是否有任何適用的新核准更新。若有的話，裝置將會自動下載更新並安裝。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Approve-CsDeviceUpdateRule Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Approve-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 物件。Approve-CsDeviceUpdateRule 接受裝置更新規則物件管線傳送的執行個體。
傳回類型
無。而是 Approve-CsDeviceUpdateRule 會核准 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Approve-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* | Approve-CsDeviceUpdateRule
上述命令會核准所有針對 WebServer:atl-cs-001.litwareinc.com 服務設定的裝置更新規則。若要這樣做，此命令會先呼叫 Get-CsDeviceUpdateRule 搭配 Filter 參數；篩選值 "service:WebServer:atl-cs-001.litwareinc.com*" 可確保只傳回 Identity 開頭字串值為 "WebServer:atl-cs-001.litwareinc.com" 的規則。(根據定義，這些規則是已指派給服務 WebServer:atl-cs-001.litwareinc.com 的裝置更新規則)。接著將篩選過的集合傳送到 Approve-CsDeviceUpdateRule 指令程式，這會核准集合中的每一個規則。
-------------------------- 範例 3 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Approve-CsDeviceUpdateRule
範例 3 所示的命令會核准指定品牌 (LG-Nortel) 的所有裝置更新規則。為達成此目的，此命令會先呼叫 Get-CsDeviceUpdateRule，以傳回所有目前在組織中使用的裝置更新規則集合。接著將這個集合傳送到 Where-Object 指令程式；這只會挑選 Brand 屬性等於 LG-Nortel 的規則。然後將篩選過的集合傳送到 Approve-CsDeviceUpdateRule，其會核准集合中的每個規則。