Import-CsDeviceUpdate
上次修改主題的時間： 2012-03-23
匯入一組自 Microsoft 網站下載的裝置更新規則。裝置更新規則可使韌體版本更新和執行 Microsoft Lync 2010 Phone Edition 的硬體裝置相關聯。
語法
Import-CsDeviceUpdate -Identity <XdsIdentity> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft 會定期發行新的 Lync 2010 Phone Edition 裝置更新規則組合。這些規則代表執行 Lync 2010 Phone Edition 之裝置的韌體更新。在匯入這些規則後，系統管理員能測試韌體更新，測試成功的話，可以將更新提供給所有在組織中使用的相關裝置。
建立新更新規則唯一的方法是從 Microsoft 下載更新套件，您不能自行建立專屬的裝置更新規則。若要取得最新的裝置更新規則組合，請前往 Microsoft 網站的 [說明及支援] 頁面並搜尋 "Phone Edition"。下載更新套件後，將檔案解壓縮至要上載之更新所在的電腦資料夾內。解壓縮檔案後，接著可以使用 Import-CsDeviceUpdate Cmdlet 匯入解壓縮後之 .CAB 檔案 (其名稱為 UCUpdates.cab) 中的裝置更新規則。
如上所述，只能本機載入更新；您需要將 UCUpdates.cab 複製到執行 Web 服務服務且需要裝載裝置更新規則的電腦上。另請記住，裝置更新規則不會在伺服器之間進行複寫。如果您想讓整個組織的所有裝置更新規則都維持同步，則需要在每部主控這些規則的伺服器上執行相同作業。例如，如果您從某部 Web 服務伺服器移除規則，則需要從其他的 Web 服務伺服器移除這個相同的規則。否則，裝置更新規則將無法同步。
您只能將更新規則匯入服務，這些規則並不適合在通用、站台或個別使用者範圍內使用。但請注意，該 Import-CsDeviceUpdate 不會自動將規則和更新新增至站台中的每個服務；只會將這些規則和更新載入特定的服務。例如，若您在執行 Web 服務的站台中有三部伺服器，將需要執行三次 Import-CsDeviceUpdate，針對每個 Web 服務執行個體各執行一次。或者，您可以使用如範例 3 所示的命令：這一個命令會擷取所有伺服器 Web 服務的 Identity，然後在這每一部伺服器上執行 Import-CsDeviceUpdate。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Import-CsDeviceUpdate Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsDeviceUpdate"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
表示要套用新更新規則的服務執行個體。例如：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 |
FileName |
選用 |
字串 |
更新檔案的路徑 (如 C:\Updates\UCUpdates.cab)。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Import-CsDeviceUpdate 不會接受管線傳送的輸入。
傳回類型
Import-CsDeviceUpdate 指令程式會匯入 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule 類別的執行個體。
範例
-------------------------- 範例 1 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName C:\Updates\UCUpdates.cab
範例 1 所示的命令可從 C:\Updates\UCUpdates.cab 檔案匯入裝置更新規則。
-------------------------- 範例 2 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName \\atl-fs-001\Updates\UCUpdates.cab
範例 2 所示的命令可從 UNC 路徑 \\atl-fs-001\Updates\UCUpdates.cab 匯入裝置更新規則。
-------------------------- 範例 3 ------------------------
Get-CsService -WebServer | ForEach-Object {Import-CsDeviceUpdate -Identity $_.Identity -FileName C:\Updates\UCUpdates.cab}
範例 3 示範如何使用單一命令將裝置更新規則匯入所有執行 Web 服務 的伺服器中。為達成此目的，此命令會先呼叫 Get-CsService 搭配 WebServer 參數，以傳回所有執行 Web 服務 服務之伺服器的集合。接著，將這個集合傳送到 ForEach-Object Cmdlet；這會依序處理集合中的每部伺服器，並使用 Import-CsDeviceUpdate 將這些伺服器的裝置更新規則更新為最新版本。請注意，唯有當您已將 UCUpdates.cab 複製到所有伺服器上的相同位置 (C:\Updates) 時，此命令才有作用。