Topic Last Modified: 2013-02-21

Retrieves information about the device update management test devices that have been configured for use in your organization. Test devices provide a way for administrators to test firmware updates before those updates are distributed to all the devices in an organization. This cmdlet was introduced in Lync Server 2010.

Syntax

Get-CsTestDevice [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsTestDevice [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

Examples

EXAMPLE 1

Example 1 returns all the test devices in the organization. Calling the Get-CsTestDevice cmdlet without any additional parameters will return all the test devices currently in use.

Copy Code
Get-CsTestDevice

EXAMPLE 2

This example returns the test device named UCPhone that was assigned to the Redmond site.

Copy Code
Get-CsTestDevice -Identity site:Redmond/UCPhone

EXAMPLE 3

In Example 3, the command returns all the test devices configured for the Redmond site.

Copy Code
Get-CsTestDevice -Identity site:Redmond  

EXAMPLE 4

Example 4 returns all the test devices that have been configured at the site scope. To do this, the command uses the Filter parameter; the filter value "site:*" limits the returned data to test devices that have an Identity that begins with the string value "site:".

Copy Code
Get-CsTestDevice -Filter site:*

Detailed Description

By identifying specific phones compatible with Lync Phone Edition or other devices as test devices, administrators can verify and approve firmware updates before those updates are rolled out to all the relevant devices in the organization. When device update rules are imported to Lync Server, they are marked as "pending," which means that the updates corresponding to these rules will not automatically be downloaded and installed by the affected devices.

Instead, these pending rules will be downloaded and installed by any relevant test devices. That’s what test devices are for: new device update rules are automatically applied to test devices, giving administrators the opportunity to verify that the firmware updates work as expected. If they do, those administrators can then mark the rules as approved; approved rules are then downloaded and installed by all the relevant devices in the organization.

Test devices can be assigned to either the global or the site scope. You can use the Get-CsTestDevice cmdlet to retrieve information about the test devices currently configured for use in your organization.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsTestDevice 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-CsTestDevice"}

Parameters

Parameter Required Type Description

Filter

Optional

System.String

Provides a way for you to use wildcard characters when specifying the test device (or devices) to be returned. For example, to return all the test device collections that have been configured at the site scope, use this syntax: -Filter "site:*". To return all the devices that have the term "EMEA" in their Identity, use this syntax: -Filter "*EMEA*". Note that Filter acts only on the Identity of the test device collection; you cannot filter on other collection properties.

Identity

Optional

Microsoft.Rtc.Management.Xds.XdsIdentity

Indicates the Identity of the test device to be returned. To refer to an individual device named UCPhone (stored in the global collection), use this syntax: -Identity global/UCPhone. To refer to a device found in a site collection, use syntax similar to this: -Identity site:Redmond/UCPhone. To refer to an entire collection, leave off the device name. For example, this syntax returns all the test devices configured for the Redmond site: -Identity site:Redmond.

Note that you cannot use wildcards when specifying an Identity.

LocalStore

Optional

System.Management.Automation.SwitchParameter

Retrieves the test device data from the local replica of the Central Management store rather than from the Central Management store itself.

Input Types

None. The Get-CsTestDevice cmdlet does not accept pipelined input.

Return Types

The Get-CsTestDevice cmdlet returns one or more instances of the Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice object.

See Also