Topic Last Modified: 2010-10-01

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.

Syntax

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

Parameters

Parameter Required Type Description

Identity

Optional

Xds Identity

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.

Filter

Optional

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.

LocalStore

Optional

Switch Parameter

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

Detailed Description

By identifying specific Microsoft Lync 2010 Phone Edition-compatible phones 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 Microsoft Lync Server 2010, 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"}

Input Types

None. Get-CsTestDevice does not accept pipelined input.

Return Types

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

Example

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

Copy Code
Get-CsTestDevice

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

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

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

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

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

Copy Code
Get-CsTestDevice -Identity site:Redmond  

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

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

Copy Code
Get-CsTestDevice -Filter site:*

The preceding command 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:".

See Also