Set-RDVirtualDesktopConcurrency
Set-RDVirtualDesktopConcurrency
Sets the number of virtual desktops that RDS can create in parallel.
Syntax
Parameter Set: Default
Set-RDVirtualDesktopConcurrency [-ConcurrencyFactor] <Int32> [[-HostServer] <String[]> ] [-ConnectionBroker <String> ] [ <CommonParameters>]
Parameter Set: Allocation
Set-RDVirtualDesktopConcurrency [-Allocation] <Hashtable> [-ConnectionBroker <String> ] [ <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 |
none |
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 |
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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
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 |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Null
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")