Set-RDVirtualDesktopConcurrency
Sets the number of virtual desktops that RDS can create in parallel.
Syntax
Default (Default)
Set-RDVirtualDesktopConcurrency
[-ConcurrencyFactor] <Int32>
[[-HostServer] <String[]>]
[-ConnectionBroker <String>]
[-BatchSize <Int32>]
[<CommonParameters>]
Allocation
Set-RDVirtualDesktopConcurrency
[-Allocation] <Hashtable>
[-ConnectionBroker <String>]
[-BatchSize <Int32>]
[<CommonParameters>]
Description
The Set-RDVirtualDesktopConcurrency cmdlet sets the number of virtual desktops that Remote Desktop Services (RDS) can create in parallel on Remote Desktop Virtualization Host (RD Virtualization Host) servers.
Examples
Example 1: Set the number of virtual desktops that RDS can create in parallel on all host servers
PS C:\> Set-RDVirtualDesktopConcurrency -ConnectionBroker "rdcb.contoso.com" -ConcurrencyFactor 4
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.
Example 2: Set the number of virtual desktops that RDS can create in parallel on host servers
PS C:\> Set-RDVirtualDesktopConcurrency -ConnectionBroker "rdcb.contoso.com" -ConcurrencyFactor 3 -HostServer @("rdvh-1.contoso.com","rdvh-2.contoso.com")
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.
Parameters
-Allocation
Specifies a collection of values (key/value pair) that specify the concurrency factor for each RD Virtualization Host server.
Parameter properties
| Type: | Hashtable |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Allocation
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-BatchSize
Specifies the batch size.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ConcurrencyFactor
Specifies the number of virtual desktops that RDS can create in parallel.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Default
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HostServer
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.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Default
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Outputs
undefined