PowerShell Logo Small

Set-RDVirtualDesktopIdleCount



This is the built-in help made by Microsoft for the command 'Set-RDVirtualDesktopIdleCount', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Sets the maximum number of idle virtual desktops on host servers.

SYNTAX


Set-RDVirtualDesktopIdleCount [-IdleCount] <Int32> [[-HostServer] <String[]>] [-ConnectionBroker <String>] [<CommonParameters>]
Set-RDVirtualDesktopIdleCount [-Allocation] <Hashtable> [-ConnectionBroker <String>] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-RDVirtualDesktopIdleCount cmdlet sets the maximum number of active but idle virtual desktops on one or more host servers. This cmdlet sets the total number of
virtual desktops that can be idle in all pools.


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.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294269
Get-RDVirtualDesktopIdleCount
Get-RDVirtualDesktop

REMARKS

<

Examples


Example 1: Set the number of idle virtual desktops on host servers

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



This command sets the maximum number of active but idle virtual desktops on the host servers named "rdvh-1.contoso.com" and "rdvh-2.contoso.com".




Example 2: Allocate idle virtual desktops to host servers

PS C:\>Set-RDVirtualDesktopIdleCount -Allocation @{"RDS-WKS-A26.contoso.com"=2;" RDS-WKS-A27.contoso.com"=4} -ConnectionBroker "rdcb.contoso.com"



This command sets the number of idle virtual desktops for specific host servers. The command allocates 2 idle virtual desktops for the host server named
"RDS-WKS-A26.contoso.com", and 4 idle virtual desktops for the host server named "RDS-WKS-A27.contoso.com".