Edit

Share via

Get-RDVirtualDesktop

  • Reference
Module:
RemoteDesktop

Gets a list of virtual desktops in the remote desktop deployment.

Syntax

Get-RDVirtualDesktop
   [[-CollectionName] <String[]>]
   [-ConnectionBroker <String>]
   [<CommonParameters>]

Description

The Get-RDVirtualDesktop cmdlet gets a list of virtual desktops in the remote desktop deployment.

Examples

Example 1: Retrieve a list of Virtual Desktops

PS C:\> Get-RDVirtualDesktop -ConnectionBroker "rdcb.contoso.com" | sort-object VirtualDesktopName

This command lists virtual desktops in the collections associated with the connection broker server named rdcb.contoso.com. The command uses the pipeline operator to send the results to the Sort-Object cmdlet, which sorts the objects in order of the VirtualDesktopName property.

Example 2: Retrieve a list of Virtual Desktops in a Collection

PS C:\> Get-RDVirtualDesktop -ConnectionBroker "rdcb.contoso.com" -CollectionName @("Virtual Desktop pool")

This command lists virtual desktops in the collection named Virtual Desktop pool that is associated with the connection broker server named rdcb.contoso.com.

Parameters

-CollectionName

Specifies an array of names of personal virtual desktop collections.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConnectionBroker

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a remote desktop deployment. If you do not specify a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Object