Get-CsTestDevice

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>]
   [-LocalStore]
   [<CommonParameters>]
Get-CsTestDevice
   [-Filter <String>]
   [-LocalStore]
   [<CommonParameters>]

Description

By identifying specific phones compatible with Skype for Business 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 Skype for Business 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.

Examples

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

Get-CsTestDevice

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.

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

Get-CsTestDevice -Identity site:Redmond/UCPhone

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

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

Get-CsTestDevice -Identity site:Redmond

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

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

Get-CsTestDevice -Filter site:*

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:".

Parameters

-Filter

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-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.

Type:XdsIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-LocalStore

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

None

Outputs

Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice