Set-CsDeviceUpdateConfiguration
上次修改主題的時間： 2012-03-26
修改裝置更新 Web 服務組態設定的集合。這些設定是用來管理裝置更新 Web 服務、可讓系統管理員將韌體更新散布至電話的 Microsoft Lync Server 2010 元件，以及執行 Microsoft Lync 2010 Phone Edition 的其他裝置。
語法
Set-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsDeviceUpdateConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
裝置更新 Web 服務提供方法讓系統管理員將韌體更新分送到執行 Microsoft Lync 2010 Phone Edition 的裝置。系統管理員會定期將一組裝置更新規則上傳到 Microsoft Lync Server 2010。在測試和核准這些規則之後，便可在適當裝置連線至系統時套用到這些裝置。裝置在最初開啟電源時會檢查更新，然後在使用者登入時再次檢查。裝置之後也會每 24 小時檢查一次更新。
裝置更新組態設定可以在全域範圍或網站範圍套用。Set-CsDeviceUpdateConfiguration 指令程式可讓您變更設定集合。例如，您可以使用此指令程式變更系統自動刪除記錄檔之前，保留記錄檔的時間長度)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsDeviceUpdateConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDeviceUpdateConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別 |
要修改之裝置更新組態設定的唯一識別碼。若要參考通用設定，請使用此語法：-Identity global。若要參考網站設定，請使用類似如下的語法：-Identity "site:Redmond"。請注意，指定 Identity 時，無法使用萬用字元。 |
Instance |
選用 |
DeviceUpdateSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
LogCleanUpInterval |
選用 |
時間範圍 |
指定保留裝置更新記錄檔的時間，此時間之後，系統會將其刪除。 此值必須以 dd.hh:mm:ss 格式輸入，其中 dd 為天數、hh 為小時數、mm 為分鐘數、ss 為秒數。若只輸入天數，則該值之後必須加上句號 (.)。 最小值：1.00:00:00 (1 天) 最大值：365.00:00:00 (1 年) 預設值：10.00:00:00 (10 天) |
LogCleanUpTimeOfDay |
選用 |
日期時間 |
表示系統檢查是否有任何應該刪除之過期記錄檔的天數 (「過期」記錄檔是指比 LogCleanupInterval 屬性中指定之值更舊的任何檔案)。 傳遞至 LogCleanupTimeOfDay 參數的值應該使用 24 小時時間格式 hh:mm，其中 hh 表示小時數，而 mm 表示分鐘數。在這個格式中，00:00 表示午夜；08:30 表示 8:30 A.M，而 23:52 表示 11:52 P.M.。 |
LogFlushInterval |
選用 |
時間範圍 |
表示儲存在記錄檔快取中的資訊寫入實際記錄檔的頻率。根據預設，裝置更新資訊不會立即寫入記錄檔；但是，該資訊會快取於記憶體中，直到：1) 記錄清除時間間隔已過期；或者 2) 快取已達大小上限。如果此值設為 10 分鐘 (00:10:00)，則快取中的資訊將會每隔 10 分鐘寫入記錄檔。當資料經過記錄之後，便會清除快取。 此值必須以 hh:mm:ss 格式輸入，其中 hh 為小時數、mm 為分鐘數、ss 為秒數。 最小值：00:01:00 (1 分鐘) 最大值：1:00:00 (1 小時) 預設值：00:05:00 |
MaxLogCacheLimit |
選用 |
整數 |
表示在必須清除快取並將資料寫入記錄檔之前，可保存在記錄檔快取中的資訊數量上限 (以位元組為單位)。根據預設，記錄檔每隔 5 分鐘便會「清除」。(如需詳細資料，請參閱參數 LogFlushInterval 的描述)。不過，如果快取達到其大小上限，其中的資訊將會自動寫入記錄檔 (而且會清除快取)，即使記錄清除間隔尚未到期也一樣。 預設值：512000 |
MaxLogFileSize |
選用 |
整數 |
表示個別記錄檔的大小上限 (以位元組為單位)。當檔案達到大小上限時，下一個批次的資料會自動寫入新記錄檔。舊記錄檔將會保留，直到記錄清除間隔已到期為止。 預設值：1024000 |
ValidLogFileExtensions |
選用 |
PS 清單修飾詞 |
表示可搭配裝置更新 Web 服務使用的有效記錄檔副檔名。此清單可以修改；不過，除非您所擁有的 Lync 2010 Phone Edition 相容裝置會建立使用不同副檔名的記錄檔，否則沒有什麼理由需要修改清單。 預設值：.dmp, .clg, .clg2, .bak, .kdmp, .dat, .bin, .cat, .xml, .txt, .hex |
ValidLogFileTypes |
選用 |
PS 清單修飾詞 |
表示裝置更新系統所保留的記錄檔類型。預設的檔案類型包括： Watson。系統損毀時，裝置自動產生的記錄檔。 Config。每當您設定 RoundTable 裝置時所建立的 Microsoft RoundTable 會議裝置設定檔。 DiagLog。RoundTable 裝置的自我診斷資料。 CELog。包含功能測試結果及重要系統事件記錄的 Lync 2010 Phone 記錄。 如果您所擁有的 Lync 2010 Phone Edition 相容裝置會建立不同種類的記錄檔，則可以新增其他檔案類型。您也可以移除檔案。例如，如果您不要儲存 CELog 檔案，則可以移除 CELog 檔案類型。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration 物件。Set-CsDeviceUpdateConfiguration 接受管線傳送的裝置更新組態物件執行個體。
傳回類型
Set-CsDeviceUpdateConfiguration 不會傳回值或物件，反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000
範例 1 會示範如何使用 Set-CsDeviceUpdateConfiguration 修改通用組態設定。在此例中，修改了兩個屬性值：MaxLogFileSize 屬性設為 2048000 個位元組，而 MaxLogCacheLimit 屬性設為 1024000 個位元組。
-------------------------- 範例 2 --------------------------
Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00
以上的命令會修改 Identity 為 site:Redmond 之裝置更新組態設定的 LogFlushInterval 屬性。若要這樣做，會使用 Identity 參數來指定 Redmond 網站的設定，並使用 LogFlushInterval 參數來指示要變更的屬性值。在此例中，LogFlushInterval 設為 2 分鐘 (00 小時 :02 分鐘 :00 秒)。
-------------------------- 範例 3 --------------------------
Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00
在範例 3 中，會修改組織中的所有裝置組態更新設定，以便將 LogCleanUpInterval 設為 14 天。為達成此目的，先使用 Get-CsDeviceUpdateConfiguration 來擷取目前正在使用的所有裝置更新組態設定集合。接著，此集合會傳送到 Set-CsDeviceUpdateConfiguration，以使用 LogCleanUpInterval 參數將集合中每個項目的記錄檔清除間隔時間設為 14 天 (14 天。00 小時 :00 分 :00 秒)。
-------------------------- 範例 4 --------------------------
Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00
範例 4 會示範如何修改已在網站範圍設定之所有裝置更新組態設定的屬性值；在此例中，此命令會將 LogCleanUpInterval 設為 20 天 (20 天。00 小時 :00 分鐘：00 秒) 的 A/V Edge 組態設定。若要執行此工作，系統會使用 Get-CsDeviceUpdateConfiguration 指令程式搭配 參數；篩選值 "site:*" 會將傳回的資料限制為 Identity 開頭字串值為 "site:" 的設定。然後，這個篩選過的集合會傳送到 Set-CsDeviceUpdateConfiguration，這會變更集合中每個項目的記錄檔清除間隔值。
-------------------------- 範例 5 --------------------------
Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}
以上的命令會將 CELog 從裝置更新組態設定所使用的有效記錄檔類型清單中移除。在此命令中，會先使用 Get-CsDeviceUpdateConfiguration 擷取目前用於組織之所有裝置更新組態設定的集合。接著，該集合會傳送到 Set-CsDeviceUpdateConfiguration，以使用 ValidLogFileTypes 參數將 CELog 從有效記錄檔類型清單中移除。傳遞到 ValidLogFileTypes, @{Remove="CELog"} 的參數值會指示 Set-CsDeviceUpdateConfiguration 從有效檔案類型集中移除 CELog。若要在單一命令中移除多個檔案類型，只要以逗號分隔清單的方式加入其他類型即可。例如：
@{Remove="CELog","Watson"}