New-CsDeviceUpdateConfiguration
上次修改主題的時間： 2012-03-23
建立新的裝置更新組態設定執行個體。這些設定是用來管理 裝置更新 Web 服務、可讓系統管理員將韌體更新散布至電話的 Microsoft Lync Server 2010 元件，以及執行 Microsoft Lync 2010 Phone Edition 的其他裝置。
語法
New-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
裝置更新 Web 服務提供方法讓系統管理員將韌體更新分送到執行 Lync 2010 Phone Edition 的裝置。系統管理員會定期將一組裝置更新規則上傳到 Lync Server 2010。在測試和核准這些規則之後，便可在適當裝置連線至系統時套用到這些裝置。裝置在最初開啟電源時會檢查更新，然後在使用者登入時再次檢查。之後，裝置每隔 24 小時檢查一次更新。
用來管理裝置更新 Web 服務的裝置更新組態設定可指派到全域層級或站台範圍。若要為站台建立新設定集合，請使用 New-CsDeviceUpdateConfiguration 指令程式。請注意，您只能在網站範圍建立新設定；如果嘗試在全域範圍建立新設定集合，則您的命令將會失敗。此外，如果嘗試建立 Redmond 網站之類的新設定集合，而且該網站已經裝載裝置更新組態設定集合，則您的命令將會失敗。那是因為每個網站只能有一個裝置更新組態設定集合。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsDeviceUpdateConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDeviceUpdateConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
表示新裝置更新組態設定的 Identity。由於只能在站台範圍建立新設定，因此 Identity 類似如下：-Identity "site:Redmond"。 |
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 表示；8:30 A.M. 以 08:30 表示；11:52 P.M. 以 23:52 表示。預設值是 Null。 |
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 |
選用 |
UInt32 |
表示在必須清除快取並將資料寫入記錄檔之前，可保存在記錄檔快取中的資訊數量上限 (以位元組為單位)。根據預設，記錄檔每隔 X 分鐘便會「清除」(如需詳細資料，請參閱參數 LogFlushInterval 的描述)。不過，如果快取達到其大小上限，其中的資訊將會自動寫入記錄檔 (而且會清除快取)，即使記錄清除間隔尚未到期也一樣。 預設值：512000 |
MaxLogFileSize |
選用 |
UInt32 |
表示個別記錄檔的大小上限 (以位元組為單位)。當檔案達到大小上限時，下一個批次的資料會自動寫入新記錄檔。舊記錄檔將會保留，直到記錄清除間隔已到期為止。 預設值：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 之電話的記錄，包含功能測試結果及重要系統事件記錄。 如果您的裝置 (執行 Lync 2010 Phone Edition) 會建立不同類型的記錄檔，則可以新增其他檔案類型。您也可以移除檔案。例如，如果您不要儲存 CELog 檔案，則可以移除 CELog 檔案類型。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsDeviceUpdateConfiguration 不接受管線傳送的輸入。
傳回類型
New-CsDeviceUpdateConfiguration 指令程式會建立 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsDeviceUpdateConfiguration -Identity site:Redmond
範例 1 所示的命令會建立 Identity 為 site:Redmond 的新裝置更新組態設定集。由於命令中未加入其他任何參數，因此這個新組態設定集合將會針對每個屬性使用預設值。
-------------------------- 範例 2 ------------------------
New-CsDeviceUpdateConfiguration -Identity site:Redmond -MaxLogFileSize 204800 -LogCleanUpInterval 7.00:00:00
以上的命令也會建立 Identity 為 site:Redmond 的新裝置更新組態設定集。在此例中，使用了兩個額外的參數，以便自訂新設定：MaxLogFileSize 用來將記錄檔大小上限設為 2048000 個位元組，而加入 LogCleanUpInterval 用於將記錄清除間隔時間設為 7 天 (7 天 .00 小時 :00 分 :00 秒)。