Clear-CsDeviceUpdateFile
上次修改主題的時間： 2012-03-23
刪除不再與裝置相關聯的已拒絕裝置更新檔。
語法
Clear-CsDeviceUpdateFile -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
每次將新裝置更新上傳至系統時，就會建立對應的裝置更新規則。根據預設，這些新裝置更新規則會被指派為「擱置」狀態；也就是說，您可以將規則下載並安裝在測試裝置上，但無法下載並安裝在生產裝置上。如此可讓您在將更新提供給使用者之前先進行測試。如果測試成功，您可以執行 Approve-CsDeviceUpdateRule 指令程式，以便將這些裝置更新提供給使用者。
如果測試不成功，則您可以使用 Reset-CsDeviceUpdateRule 或 Restore-CsDeviceUpdateRule 指令程式來拒絕更新。執行這些指令程式時，裝置更新會與其裝置更新規則解除關聯。這時候系統管理員就可以使用 Clear-CsDeviceUpdateFile 指令程式，從伺服器移除已解除關聯的更新。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Clear-CsDeviceUpdateFile Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Clear-CsDeviceUpdateFile"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
裝載裝置更新檔之服務的唯一識別碼。例如，此語法會從 atl-cs-001.litwareinc.com 集區的 Web 服務 服務清除裝置更新檔：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Clear-CsDeviceUpdateFile 不接受管線傳送的輸入。
傳回類型
無。Clear-CsDeviceUpdateFile 不會傳回任何值。
範例
-------------------------- 範例 1 ------------------------
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com"
範例 1 所示的命令會從 WebServer:atl-cs-001.litwareinc.com 服務刪除不再與裝置相關聯的所有裝置更新檔。