Get-CsDeviceUpdateConfiguration
上次修改主題的時間： 2012-03-23
傳回目前部署於您組織中之裝置更新組態設定的相關資訊。這些設定有助於管理 裝置更新 Web 服務，亦即Microsoft Lync Server 2010 元件，該元件可讓系統管理員將韌體更新分送到執行 Microsoft Lync 2010 Phone Edition 的電話與其他裝置。
語法
Get-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDeviceUpdateConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
裝置更新 Web 服務提供方法讓系統管理員將韌體更新分送到執行 Lync 2010 Phone Edition 的裝置。系統管理員會定期將一組裝置更新規則上傳到 Lync Server 2010。在測試和核准這些規則之後，便可在適當裝置連線至系統時套用到這些裝置。裝置在最初開啟電源時會檢查更新，然後在使用者登入時再次檢查。之後，裝置每隔 24 小時檢查一次更新。
裝置更新 Web 服務是使用裝置組態設定來管理；這些設定會在全域範圍或站台範圍套用。您可使用 Get-CsDeviceUpdateConfiguration 指令程式，以傳回目前使用於您組織中之裝置更新組態設定的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsDeviceUpdateConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Approve-CsDeviceUpdateRule"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
表示要擷取之裝置更新組態設定的 Identity。若要參照通用設定，請使用此語法：-Identity global。若要參照站台設定，請使用類似如下的語法：-Identity site:Redmond。請注意，在指定 Identity 時無法使用萬用字元。如果您需要使用萬用字元，請改用 Filter 參數。 |
Filter |
選用 |
Xds Identity Filter |
讓您可以在指定裝置更新組態設定時使用萬用字元。例如，若要傳回已在網站範圍套用之所有組態設定的集合，請使用以下語法：-Filter "site:*"。若要傳回 Identity 中具有術語 "EMEA" 的所有設定，請使用這個語法：-Filter "*EMEA*"。請注意，Filter 參數僅在設定的 Identity 上執行；您無法在其他裝置更新組態屬性上進行篩選。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取裝置更新組態資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsDeviceUpdateConfiguration 不會接受管線傳送的輸入。
傳回類型
Get-CsDeviceUpdateConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsDeviceUpdateConfiguration
範例 1 所示的命令會傳回目前您組織中使用之所有裝置更新組態設定的集合。呼叫不含任何額外參數的 Get-CsDeviceUpdateConfiguration，會傳回目前正在使用的所有裝置更新設定。
-------------------------- 範例 2 ------------------------
Get-CsDeviceUpdateConfiguration -Identity Global
在範例 2 中，會傳回通用裝置更新組態設定的資訊。
-------------------------- 範例 3 ------------------------
Get-CsDeviceUpdateConfiguration -Filter site:*
範例 3 會示範 Filter 參數的使用方法。篩選值 "site:*" 會傳回在站台範圍套用之所有裝置更新組態設定的集合；這是因為這些設定皆具有以字串值 "site:" 開頭的 Identity。
-------------------------- 範例 4 ------------------------
Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -gt 2048000}
上述命令會傳回 MaxLogFileSize 屬性大於 2048000 位元組的所有裝置更新組態設定。為達成此目的，使用 Get-CsDeviceUpdateConfiguration 來傳回目前正在使用的所有裝置更新組態設定集合。接著將該集合傳送給 Where-Object，這樣只會挑選出 MaxLogFileSize 屬性大於 2048000 的那些設定。
-------------------------- 範例 5 ------------------------
Get-CsDeviceUpdateConfiguration | Where-Object {$_.ValidLogFileTypes -like "*Watson*"}
範例 5 所示的命令會傳回所有包含將 "Watson" 作為有效記錄檔類型的裝置更新組態設定。若要完成這項工作，使用 Get-CsDeviceUpdateConfiguration 來傳回所有裝置更新組態設定的集合。接著將該集合傳送到 Where-Object，其只會挑出在有效記錄檔類型組中包含 "Watson" 的裝置設定。