Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Set-RDVirtualDesktopConcurrency

Set-RDVirtualDesktopConcurrency

remotedesktop.psm1

Synopsis

Sets the number of virtual desktops that RDS can create in parallel.

Syntax

Set-RDVirtualDesktopConcurrency [-ConcurrencyFactor] [-HostServer] [-ConnectionBroker] [<CommonParameters>]

Set-RDVirtualDesktopConcurrency [-Allocation] [-ConnectionBroker] [<CommonParameters>]

Detailed Description

The Set-RDVirtualDesktopConcurrency cmdlet sets the number of virtual desktops that Remote Desktop Services can create in parallel on Remote Desktop Virtualization Host (RD Virtualization Host) servers.

Parameters

-Allocation <Hashtable>

Specifies a collection of values (key=value pair) that specify the concurrency factor for each RD Virtualization Host server.

Aliases

None

Required?

true

Position

1

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-ConcurrencyFactor <Int32>

Specifies the number of virtual desktops that RDS can create in parallel.

Aliases

None

Required?

true

Position

1

Default value

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.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-HostServer <String[]>

Specifies the name of the server that hosts 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.

Aliases

None

Required?

false

Position

2

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type


Return Type

Null

Notes

None

Examples

Example 1: Set the number of virtual desktops that RDS can create in parallel on all host servers

This command sets the number of virtual desktops that Remote Desktop Services (RDS) can create in parallel to 4 on all the host servers associated with the RD Connection Broker server named "rdcb.contoso.com".

PS C:\> Set-RDVirtualDesktopConcurrency -ConnectionBroker "rdcb.contoso.com" -ConcurrencyFactor 4

Example 2: Set the number of virtual desktops that RDS can create in parallel on host servers

This command sets the number of virtual desktops that Remote Desktop Services (RDS) can create in parallel to 3 on the host servers named "rdvh-1.contoso.com" and "rdvh-2.contoso.com".

PS C:\> Set-RDVirtualDesktopConcurrency -ConnectionBroker "rdcb.contoso.com" -ConcurrencyFactor 3 -HostServer @("rdvh-1.contoso.com","rdvh-2.contoso.com")

Online Version
Get-RDVirtualDesktopConcurrency