Parameters

Microsoft Lync Server 2010 uses device update rules as a way to provide firmware updates to devices that run Lync 2010 Phone Edition. Periodically, administrators upload a set of device update rules to Lync Server 2010; after those rules have been tested and approved, they are automatically downloaded and applied to the appropriate devices as those devices connect to the system. By default devices check for new update rules each time they turn on and connect to Lync Server. Devices also check for updates every 24 hours after that initial sign on.

Device update rules can be imported (and applied to) the Web Services service. The Get-CsDeviceUpdateRule cmdlet enables you to return information about the device update rules that have been imported for use in your organization.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsDeviceUpdateRule cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDeviceUpdateRule"}

None. Get-CsDeviceUpdateRule does not accept pipelined input.

Get-CsDeviceUpdateRule returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule object.

-------------------------- Example 1 ------------------------

	Copy Code
Get-CsDeviceUpdateRule

The preceding command returns information about all the device update rules that have been applied in your organization. Calling Get-CsDeviceUpdateRule without any additional parameters always returns the complete collection of device update rules.

-------------------------- Example 2 ------------------------

	Copy Code
Get-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

The command shown in Example 2 returns information about the device update rule with the Identity "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

-------------------------- Example 3 ------------------------

	Copy Code
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com*

Example 3 returns information about all the device update rules configured for the service WebServer:atl-cs-001.litwareinc.com. To accomplish this task, the Filter parameter is used along with the filter value "WebServer:atl-cs-001.litwareinc.com*". That filter limits the returned data to device update rules that have an Identity that begins with the string value "service:WebServer:atl-cs-001.litwareinc.com."

-------------------------- Example 4 ------------------------

	Copy Code
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}

The preceding command returns all the device update rules where the Brand property is equal to "LG-Nortel". To do this, Get-CsDeviceUpdateRule is called in order to return a collection of all the device update rules in the organization. That collection is then piped to the Where-Object cmdlet, which selects only those rules where the Brand is equal to "LG-Nortel".

-------------------------- Example 5 ------------------------

	Copy Code
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

Example 5 returns a collection of all the device update rules that have not been approved. This is done by using Get-CsDeviceUpdateRules to return a collection of all the rules and then piping that collection to Where-Object. In turn, Where-Object selects only those rules where the Approved property is equal to a null value. If the Approved property is null, it means that these rules are not approved.

-------------------------- Example 6 ------------------------

	Copy Code
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}

The command shown above returns a collection of all the device update rules that meet two criteria: the rule has been approved and the rule relates to LG-Nortel devices. To accomplish this task, Get-CsDeviceUpdateRule is first called to return a collection of all the device update rules in the organization. That collection is then piped to Where-Object, which filters the collection on two criteria: the Approved property must not be null (that is, this property must have a value of some kind); and the Brand must be equal to "LG-Nortel".

Other Resources