# 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.