Returns information about the device update configuration settings currently deployed in your organization. These settings help manage the device update service, a Microsoft Communications Server 2010 component that enables administrators to distribute firmware updates to telephones and other devices running Microsoft Communicator “14” Phone Edition.
Syntax
Get-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] |
Get-CsDeviceUpdateConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Optional |
XdsIdentity |
Indicates the Identity of the device update configuration settings to be retrieved. To refer to the global settings, use this syntax: -Identity global. To refer to site settings, use syntax similar to this: -Identity site:Redmond. Note that you cannot use wildcards when specifying an Identity. |
|
Filter |
Optional |
XdsIdentityFilter |
Provides a way for you to use wildcard characters when specifying device update configuration settings. For example, to return a collection of all the update configuration settings that have been applied at the site scope use this syntax: -Filter "site:*". To return all the settings that have the term "EMEA" in their Identity use this syntax: -Filter "*EMEA*". Note that -Filter acts only on the Identity of the settings; you cannot filter on other device update configuration properties. |
|
LocalStore |
Optional |
Switch Parameter |
Detailed Description
The device update service provides a way for administrators to distribute firmware updates to devices (such as Tanjay phones and Roundtable conference stations) that run Communicator “14” Phone Edition. Periodically, administrators upload a set of device update rules to Communications Server 2010; after those rules have been tested and approved, they are then automatically downloaded and applied to the appropriate devices as those devices connect to the system. You can use the Get-CsDeviceUpdateConfiguration cmdlet to return information about the device update configuration settings currently in use in your organization.
Return Types
Get-CsDeviceUpdateConfiguration returns instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Get-CsDeviceUpdateConfiguration |
|
The command shown in Example 1 returns a collection of all the device update configuration settings currently in use in the organization. Calling Get-CsDeviceUpdateConfiguration without specifying any additional parameters will return all the device update settings.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Get-CsDeviceUpdateConfiguration -Identity Global |
|
In Example 2, information is returned for the global device update configuration settings and only for the global settings.
-------------------------- Example 3 ------------------------
| Copy Code |
|
|---|---|
Get-CsDeviceUpdateConfiguration -Filter site:* |
|
Example 3 demonstrates the use of the -Filter parameter. The filter value "site:*" returns a collection of all the device update configuration settings applied at the site scope; that’s because these settings all have an Identity that begins with the string value "site:".
-------------------------- Example 4 ------------------------
| Copy Code |
|
|---|---|
Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -gt 2048000}
|
|
The preceding command returns all the device update configuration settings where the MaxLogFileSize property is greater than (-gt) 2048000 bytes. To do this, Get-CsDeviceUpdateConfiguration is used to return a collection of all the device update configuration settings currently in use. That collection is then piped to the Where-Object, which picks out only those settings where the MaxLogFileSize property is greater than 2048000.
-------------------------- Example 5 ------------------------
| Copy Code |
|
|---|---|
Get-CsDeviceUpdateConfiguration | Where-Object {$_.ValidLogFileTypes -like "*Watson*"}
|
|
The command shown in Example 5 returns all the device update configuration settings that include "Watson" as a valid log file type. To accomplish this task, Get-CsDeviceUpdateConfiguration is used to return a collection of all the device update configuration settings. That collection is then piped to the Where-Object, which picks out only the device settings that include "Watson" ($_.ValidLogFileTypes -like "*Watson*") in their list of valid log file type.