< Back

Get-RDVirtualDesktopIdleCount

Thu Apr 04, 2019 5:42 am

NAME Get-RDVirtualDesktopIdleCount



SYNOPSIS

Gets the number of idle virtual desktops on hosts.





SYNTAX

Get-RDVirtualDesktopIdleCount [[-HostServer] <String[]>] [-BatchSize <System.Int32>] [-ConnectionBroker <String>] [<CommonParameters>]





DESCRIPTION

The Get-RDVirtualDesktopIdleCount cmdlet gets the number of idle virtual desktops on one or more hosts. This cmdlet returns a value that

represents the number of idle virtual desktops from every pool.



An idle virtual desktop is a virtual machine that is in a running state and there is no user logged on to it. Idle virtual desktops continue to

run even if you configured the pool so that the server saves a virtual desktop that is not in use.





PARAMETERS

-BatchSize [<System.Int32>]

Specifies the batch size.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-ConnectionBroker [<String>]

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.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-HostServer [<String[]>]

Specifies an array of names of the servers that host the session. For session collections the host server has the name of the Remote Desktop

Session Host (RD Session Host) server. For virtual desktop collections the host server has the name of the Remote Desktop Virtualization Host

(RD Virtualization Host) server.



Required? false

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS











OUTPUTS











Example 1: Count idle virtual desktops on hosts



PS C:\\>Get-RDVirtualDesktopIdleCount -HostServer @("rdvh-1.contoso.com","rdvh-2.contoso.com") -ConnectionBroker "rdcb.contoso.com"



This command gets the number of idle virtual desktops associated with the connection broker named rdcb.contoso.com on the host servers named

rdvh-1.contoso.com and rdvh-2.contoso.com.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294230

Set-RDVirtualDesktopIdleCount

Get-RDVirtualDesktopCollectionConfiguration