# New-RASAVDHostPool

## NAME

New-RASAVDHostPool

## SYNOPSIS

The cmdlet creates an object of type Azure Virtual Desktop Host Pool.

## SYNTAX

**New-RASAVDHostPool** \[\[-[SiteId](#siteid-string)]\*\*_(uint)_] -[AzureId](#azureid-string) _(string)_\
-[HostName](#hostname-string) _(string)_\
-[WorkspaceId](#workspaceid-string) _(uint)_\
\[[AutoScaleEnabled](#autoscaleenabled-string)_(bool)_]\
\[-[DefaultPowerState](#DefaultPowerState)\
{PoweredOn | PoweredOff | Suspended}]\
\[[DrainRemainsBelowSec](#drainremainsbelowsec-string)_(uint)_] \[[Duration](#duration-string)_(uint)_] \[[Enabled](#enabled-string) _(bool)_]\
\[[HostsToCreate](#hoststocreate-string) _(uint)_]\
\[[MaxHosts](#maxhosts-string) _(uint)_]\
\[[MaxServersFromTemplate](#maxserversfromtemplate-string)_(uint)_]\
\[[MinServersFromTemplate](#minserversfromtemplate-string)_(uint)_] \[[OverwriteSize](#overwritesize-string)_(bool)_]\
\[[PreCreatedHosts](#precreatedhosts-string)_(uint)_]\
\[[RemoveServersAfterDrainAndPowerOff](#removeserversafterdrainandpoweroff-string)_(bool)_]\
\[[ServersToAddPerRequest](#serverstoaddperrequest-string)_(uint)_] \[[TemplateId](#templateid-string)_(uint)_] \[[TemplateTagId](#templatetagid-string)_(uint)_]\
\[[TemplateVersionId](#templateversionid-string)_(uint)_]\
\[[ValidationEnvironment](#validationenvironment-string)_(bool)_] \[[VMSize](#vmsize-string) _(string)_]\
\[[WorkLoadDrain](#workloaddrain-string) _(uint)_]\
\[[WorkloadThreshold](#workloadthreshold-string)_(uint)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

**New-RASAVDHostPool** \[[Name](#name-string)]\*\*_(string)_ \[\[-[SiteId](#siteid-string)]_(uint)_]\
-[LoadBalancerType](#LoadBalancerType)\
{BreadthFirst | DepthFirst | Persistent}\
-[Location](#location-string) _(string)_\
-[PoolType](#PoolType) {Pooled | Personal}\
-[ProvisioningType](#ProvisioningType) {Template\
\| Standalone} -[PublishingType](#PublishingType)\
{RemoteApp | Desktop}\
-[ResourceGroup](#resourcegroup-string) _(string)_\
-[WorkspaceId](#workspaceid-string) _(uint)_\
\[[AutoScaleEnabled](#autoscaleenabled-string)_(bool)_]\
\[-[DefaultPowerState](#DefaultPowerState)\
{PoweredOn | PoweredOff | Suspended}]\
\[[Description](#description-string) _(string)_]\
\[[DrainRemainsBelowSec](#drainremainsbelowsec-string)_(uint)_] \[[Duration](#duration-string)_(uint)_] \[[Enabled](#enabled-string) _(bool)_]\
\[[FriendlyName](#friendlyname-string) _(string)_]\
\[[HostName](#hostname-string) _(string)_]\
\[[HostsToCreate](#hoststocreate-string) _(uint)_]\
\[[LimitHosts](#limithosts-string) _(uint)_]\
\[[MaxHosts](#maxhosts-string) _(uint)_]\
\[[MaxServersFromTemplate](#maxserversfromtemplate-string)_(uint)_]\
\[[MinServersFromTemplate](#minserversfromtemplate-string)_(uint)_] \[[OverwriteSize](#overwritesize-string)_(bool)_] \[[PowerOnHost](#poweronhost-string)_(bool)_]\
\[[PreCreatedHosts](#precreatedhosts-string)_(uint)_]\
\[[RemoveServersAfterDrainAndPowerOff](#removeserversafterdrainandpoweroff-string)_(bool)_]\
\[[ServersToAddPerRequest](#serverstoaddperrequest-string)_(uint)_] \[[TemplateId](#templateid-string)_(uint)_] \[[TemplateTagId](#templatetagid-string)_(uint)_]\
\[[TemplateVersionId](#templateversionid-string)_(uint)_]\
\[[ValidationEnvironment](#validationenvironment-string)_(bool)_] \[[VMSize](#vmsize-string) _(string)_]\
\[[WorkLoadDrain](#workloaddrain-string) _(uint)_]\
\[[WorkloadThreshold](#workloadthreshold-string)_(uint)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

## DESCRIPTION

Creates a new Azure Virtual Desktop Host Pool or imports an existing\
Azure Virtual Desktop Host Pool

## 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](../types/pooltype))

The Pool Type of the 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).

Available to Pooled Host Pools

```
        Required?                    false

        Position?                    named

        Default value                50

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## PublishingType ([PublishingType](../types/publishingtype))

The Publishing Type of the AVD Host Pool.

Possible values: RemoteApp, Desktop

```
        Required?                    true

        Position?                    named

        Default value                RemoteApp

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## LoadBalancerType

([LoadBalancerType](../types/loadbalancertype))\
The Load Balancer Type of the 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)

Whether Power On Host is Enabled or not.

```
        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](../types/provisioningtype))\
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.

Available to Templated Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## TemplateVersionId (uint)

The Template Version ID.

Available to Templated Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## TemplateTagId (uint)

The Template Tag ID.

Available to Templated Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## MaxHosts (uint)

The maximum number of hosts that can be created from the template.

Available to Templated Personal Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## PreCreatedHosts (uint)

The maximum number of pre-created hosts. (Keep available buffer)

Available to Templated Personal Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Duration (uint)

The duration (in seconds) before the unused hosts are deleted

Available to Templated Personal Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## HostsToCreate (uint)

The number of hosts that will be created after template creation process\
has finished. These desktops are created only once.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## AutoScaleEnabled (bool)

Whether AutoScale is Enabled or not

Available to Templated Pooled Host Pools

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

        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                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## WorkloadThreshold (uint)

The Workload Threshold.

Default: 75

```
        Required?                    false

        Position?                    named

        Default value                

        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                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## WorkLoadDrain (uint)

The Drain Workload.

Default: 20

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DrainRemainsBelowSec (uint)

The Remaining Drain level.

Default: 1 (Immediate)

```
        Required?                    false

        Position?                    named

        Default value                

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

## HostName (string)

The host name format. All VMs created from the template will have this\
name with %ID:N:S% replaced.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DefaultPowerState

([DefaultPowerState](../types/defaultpowerstate))\
The Default Power State

Possible values: PoweredOn, PoweredOff, Suspended

```
        Required?                    false

        Position?                    named

        Default value                PoweredOn

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## OverwriteSize (bool)

Whether Overwrite Size is Enabled or not.

Available to Templated Host Pools

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## VMSize (string)

VMSize which will override the size specified in template properties.

Example: Standard\_B2s

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

## INPUTS

-none-

## OUTPUTS

[AVDHostPool](../types/avdhostpool)

## EXAMPLES

\*\*---------- 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 AVD Host Pool.\
\*\*---------- 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 AVD Host Pool.\
\*\*---------- EXAMPLE 3 ----------

New-RASAVDHostPool -WorkspaceId 1 -AzureId\
"subscriptions/b0375739-05f3-859f-ac89-20ef4dcd92cb/resourceGroups/My\_Resource\_Group/providers/Microsoft.DesktopVirtualization/hostpools/my-hostpool"

Imports an existing AVD Host Pool.

## RELATED LINKS

* [Get-RASAVDHostPool](get-rasavdhostpool)
* [Set-RASAVDHostPool](set-rasavdhostpool)
* [Remove-RASAVDHostPool](remove-rasavdhostpool)
