# New-RASAVDHostPool ### NAME New-RASAVDHostPool\
### SYNOPSIS The cmdlet creates an object of type Azure Virtual Desktop Host Pool.\
### SYNTAX New-RASAVDHostPool \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#SiteId)] *\*] -[AzureId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#AzureId) *\* -[WorkspaceId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkspaceId) *\* \[-[AutoScaleEnabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#AutoScaleEnabled) *\*] \[-[DefaultPowerState](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#DefaultPowerState) {PoweredOn | PoweredOff | Suspended}] \[-[DrainRemainsBelowSec](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#DrainRemainsBelowSec) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Enabled) *\*] \[-[HostName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#HostName) *\*] \[-[MaxServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MaxServersFromTemplate) *\*] \[-[MinServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MinServersFromTemplate) *\*] \[-[RemoveServersAfterDrainAndPowerOff](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#RemoveServersAfterDrainAndPowerOff) *\*] \[-[ServersToAddPerRequest](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ServersToAddPerRequest) *\*] \[-[TemplateId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateId) *\*] \[-[TemplateVersionId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateVersionId) *\*] \[-[ValidationEnvironment](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ValidationEnvironment) *\*] \[-[WorkLoadDrain](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkLoadDrain) *\*] \[-[WorkloadThreshold](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkloadThreshold) *\*] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#CommonParameters)*>*]\ \ New-RASAVDHostPool \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#SiteId)] *\*] -[LoadBalancerType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#LoadBalancerType) {BreadthFirst | DepthFirst | Persistent} -[Location](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Location) *\* -[PoolType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#PoolType) {Pooled | Personal} -[ProvisioningType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ProvisioningType) {Template | Standalone} -[PublishingType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#PublishingType) {RemoteApp | Desktop} -[ResourceGroup](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ResourceGroup) *\* -[WorkspaceId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkspaceId) *\* \[-[AutoScaleEnabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#AutoScaleEnabled) *\*] \[-[DefaultPowerState](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#DefaultPowerState) {PoweredOn | PoweredOff | Suspended}] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Description) *\*] \[-[DrainRemainsBelowSec](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#DrainRemainsBelowSec) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Enabled) *\*] \[-[FriendlyName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#FriendlyName) *\*] \[-[HostName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#HostName) *\*] \[-[LimitHosts](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#LimitHosts) *\*] \[-[MaxServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MaxServersFromTemplate) *\*] \[-[MinServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MinServersFromTemplate) *\*] \[-[PowerOnHost](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#PowerOnHost) *\*] \[-[RemoveServersAfterDrainAndPowerOff](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#RemoveServersAfterDrainAndPowerOff) *\*] \[-[ServersToAddPerRequest](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ServersToAddPerRequest) *\*] \[-[TemplateId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateId) *\*] \[-[TemplateVersionId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateVersionId) *\*] \[-[ValidationEnvironment](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ValidationEnvironment) *\*] \[-[WorkLoadDrain](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkLoadDrain) *\*] \[-[WorkloadThreshold](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkloadThreshold) *\*] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#CommonParameters)*>*]\
### DESCRIPTION Creates a new Azure Virtual Desktop Host Pool or imports an existing Azure Virtual Desktop Host Pool\ \ This is an Experimental feature which is subject to slight changes.\
### PARAMETERS \ -**Name \**\ The name of the AVD Host Pool.\
``` Required? true ``` ``` Position? 0 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SiteId \**\ Site ID in which to modify the specified AVD Host Pool.\ \ If the parameter is omitted, the site ID of the Licensing Server will be used.\
``` Required? false ``` ``` Position? 1 ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**WorkspaceId \**\ The Workspace ID.\
``` Required? true ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Description \**\ Description of the AVD Host Pool.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Enabled \**\ Enable or disable the AVD Host Pool upon creation.\ \ If the parameter is omitted, the AVD Host Pool is initialised as Disabled.\
``` Required? false ``` ``` Position? named ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**FriendlyName \**\ Friendly name of the AVD Host Pool.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ResourceGroup \**\ Resource Group of the AVD Host Pool.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Location \**\ Location of the AVD Host Pool.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**AzureId \**\ The Azure ID of the AVD Host Pool.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PoolType <**[**PoolType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PoolType.html)**>**\ The Type of AVD Host Pool.\ \ Possible values: Pooled, Personal\
``` Required? true ``` ``` Position? named ``` ``` Default value Pooled ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LimitHosts \**\ The Limit of session on host. Default: Pooled: 50, Personal: 1 (always).\
``` Required? false ``` ``` Position? named ``` ``` Default value 50 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PublishingType <**[**PublishingType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/PublishingType.html)**>**\ The Type of AVD Host Pool.\ \ Possible values: RemoteApp, Desktop\
``` Required? true ``` ``` Position? named ``` ``` Default value RemoteApp ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LoadBalancerType <**[**LoadBalancerType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/LoadBalancerType.html)**>**\ The Type of AVD Host Pool.\ \ Possible values: BreadthFirst, DepthFirst, Persistent\
``` Required? true ``` ``` Position? named ``` ``` Default value BreadthFirst ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PowerOnHost \**\ The Type of AVD Host Pool.\
``` Required? false ``` ``` Position? named ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ValidationEnvironment \**\ Whether Validation Environment is Enabled or not.\
``` Required? false ``` ``` Position? named ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ProvisioningType <**[**ProvisioningType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/ProvisioningType.html)**>**\ The Provisioning Type of the Host Pool\ \ Possible values: Template, Standalone\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**TemplateId \**\ The Template ID.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**TemplateVersionId \**\ The RAS Template Version ID.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**AutoScaleEnabled \**\ Whether AutoScale is Enabled or not\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MinServersFromTemplate \**\ The Minimum Number of Hosts added from the template.\ \ Default: 1\
``` Required? false ``` ``` Position? named ``` ``` Default value 1 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MaxServersFromTemplate \**\ The Maximum Number of Hosts added from the template.\ \ Default: 2\
``` Required? false ``` ``` Position? named ``` ``` Default value 2 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**HostName \**\ The host name format. All VMs created from the template will have this name with %ID:N:S% replaced.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**DefaultPowerState <**[**DefaultPowerState**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/DefaultPowerState.html)**>**\ The Default Power State\ \ Possible values: PoweredOn, PoweredOff, Suspended\
``` Required? false ``` ``` Position? named ``` ``` Default value PoweredOn ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**WorkloadThreshold \**\ The Workload Threshold.\ \ Default: 75\
``` Required? false ``` ``` Position? named ``` ``` Default value 75 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ServersToAddPerRequest \**\ The amount of servers to add per request.\ \ Default: 1\
``` Required? false ``` ``` Position? named ``` ``` Default value 1 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**WorkLoadDrain \**\ The Drain Workload.\ \ Default: 20\
``` Required? false ``` ``` Position? named ``` ``` Default value 20 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**DrainRemainsBelowSec \**\ The Remaining Drain level.\ \ Default: 0 (Immediate)\
``` Required? false ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**RemoveServersAfterDrainAndPowerOff \**\ Remove hosts from host pool after drain and power off.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ \ ``` This cmdlet supports the common parameters: Verbose, Debug, ``` ``` ErrorAction, ErrorVariable, WarningAction, WarningVariable, ``` ``` OutBuffer, PipelineVariable, and OutVariable. For more information, see ``` ``` about_CommonParameters . ```
### INPUTS -none- ### OUTPUTS [AVDHostPool](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/AVDHostPool.html) ### EXAMPLES \ \&#xNAN;**---------- EXAMPLE 1 ----------**\ \ New-RASAVDHostPool -Name "NGTstHostPool" -WorkspaceId 5 -ResourceGroup "NGResource" -Location "westeurope" -PoolType Pooled -PublishingType "Desktop" -ProvisioningType Template -LoadBalancer "DepthFirst"\ \ Creates a new Pooled Templated Azure Virtual Desktop Host Pool.\ \&#xNAN;**---------- EXAMPLE 2 ----------**\ \ New-RASAVDHostPool -Name "NGTstHostPool" -WorkspaceId 5 -ResourceGroup "NGResource" -Location "westeurope" -PoolType Personal -PublishingType "Desktop" -ProvisioningType Template -LoadBalancer "Persistent"\ \ Creates a new Personal Templated Azure Virtual Desktop Host Pool.\ \&#xNAN;**---------- EXAMPLE 3 ----------**\ \ New-RASAVDHostPool -WorkspaceId 1 -ProviderId 1 -AzureId "subscriptions/b0375739-05f3-859f-ac89-20ef4dcd92cb/resourceGroups/My\_Resource\_Group/providers/Microsoft.DesktopVirtualization/hostpools/my-hostpool"\ \ Imports an existing Azure Virtual Desktop Host Pool. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.parallels.com/landing/ras-powershell-api-guide/v19/parallels-ras-powershell-admin-module/commands/new-rasavdhostpool.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.