# 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)] _\<uint>_] -[AzureId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#AzureId) _\<string>_ -[WorkspaceId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkspaceId) _\<uint>_ \[-[AutoScaleEnabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#AutoScaleEnabled) _\<bool>_] \[-[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) _\<uint>_] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Enabled) _\<bool>_] \[-[HostName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#HostName) _\<string>_] \[-[MaxServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MaxServersFromTemplate) _\<uint>_] \[-[MinServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MinServersFromTemplate) _\<uint>_] \[-[RemoveServersAfterDrainAndPowerOff](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#RemoveServersAfterDrainAndPowerOff) _\<bool>_] \[-[ServersToAddPerRequest](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ServersToAddPerRequest) _\<uint>_] \[-[TemplateId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateId) _\<uint>_] \[-[TemplateVersionId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateVersionId) _\<uint>_] \[-[ValidationEnvironment](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ValidationEnvironment) _\<bool>_] \[-[WorkLoadDrain](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkLoadDrain) _\<uint>_] \[-[WorkloadThreshold](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkloadThreshold) _\<uint>_] \[_<_[_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)] _\<string>_ \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#SiteId)] _\<uint>_] -[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) _\<string>_ -[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) _\<string>_ -[WorkspaceId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkspaceId) _\<uint>_ \[-[AutoScaleEnabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#AutoScaleEnabled) _\<bool>_] \[-[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) _\<string>_] \[-[DrainRemainsBelowSec](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#DrainRemainsBelowSec) _\<uint>_] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#Enabled) _\<bool>_] \[-[FriendlyName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#FriendlyName) _\<string>_] \[-[HostName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#HostName) _\<string>_] \[-[LimitHosts](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#LimitHosts) _\<uint>_] \[-[MaxServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MaxServersFromTemplate) _\<uint>_] \[-[MinServersFromTemplate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#MinServersFromTemplate) _\<uint>_] \[-[PowerOnHost](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#PowerOnHost) _\<bool>_] \[-[RemoveServersAfterDrainAndPowerOff](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#RemoveServersAfterDrainAndPowerOff) _\<bool>_] \[-[ServersToAddPerRequest](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ServersToAddPerRequest) _\<uint>_] \[-[TemplateId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateId) _\<uint>_] \[-[TemplateVersionId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#TemplateVersionId) _\<uint>_] \[-[ValidationEnvironment](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#ValidationEnvironment) _\<bool>_] \[-[WorkLoadDrain](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkLoadDrain) _\<uint>_] \[-[WorkloadThreshold](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASAVDHostPool.html#WorkloadThreshold) _\<uint>_] \[_<_[_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 \<string>**\
The name of the AVD Host Pool.\
\


```
        Required?                    true
```

```
        Position?                    0
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**SiteId \<uint>**\
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 \<uint>**\
The Workspace ID.\
\


```
        Required?                    true
```

```
        Position?                    named
```

```
        Default value                0
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**Description \<string>**\
Description of the AVD Host Pool.\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**Enabled \<bool>**\
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 \<string>**\
Friendly name of the AVD Host Pool.\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**ResourceGroup \<string>**\
Resource Group of the AVD Host Pool.\
\


```
        Required?                    true
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**Location \<string>**\
Location of the AVD Host Pool.\
\


```
        Required?                    true
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**AzureId \<string>**\
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 \<uint>**\
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 \<bool>**\
The Type of AVD Host Pool.\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                False
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**ValidationEnvironment \<bool>**\
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 \<uint>**\
The Template ID.\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**TemplateVersionId \<uint>**\
The RAS Template Version ID.\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**AutoScaleEnabled \<bool>**\
Whether AutoScale is Enabled or not\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**MinServersFromTemplate \<uint>**\
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 \<uint>**\
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 \<string>**\
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 \<uint>**\
The Workload Threshold.\
\
Default: 75\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                75
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**ServersToAddPerRequest \<uint>**\
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 \<uint>**\
The Drain Workload.\
\
Default: 20\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                20
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**DrainRemainsBelowSec \<uint>**\
The Remaining Drain level.\
\
Default: 0 (Immediate)\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                0
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
-**RemoveServersAfterDrainAndPowerOff \<bool>**\
Remove hosts from host pool after drain and power off.\
\


```
        Required?                    false
```

```
        Position?                    named
```

```
        Default value                
```

```
        Accept pipeline input?       false
```

```
        Accept wildcard characters?  false
```

\
\<CommonParameters>

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