> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/new-rasavdhostpool.md).

# New-RASAVDHostPool

## SYNOPSIS

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

## SYNTAX

```powershell
New-RASAVDHostPool [[-SiteId] <uint>] -AzureId <string> -HostName <string> -WorkspaceId <uint>
 [-AutoScaleEnabled <bool>]
 [-AvailabilityOptions {NoInfrastructure | AvailabilitySet | AvailabilityZone}]
 [-AvailabilityPreferredZone {Zone1 | Zone2 | Zone3}]
 [-DefaultPowerState {PoweredOn | PoweredOff | Suspended}] [-DeployLocation {Standard | Hybrid}]
 [-DomainOrgUnit <string>] [-DrainRemainsBelowSec <uint>] [-Duration <uint>] [-Enabled <bool>]
 [-HostsToCreate <uint>] [-HybridHostPoolId <uint>] [-MaxHosts <uint>]
 [-MaxServersFromTemplate <uint>] [-MinServersFromTemplate <uint>] [-OverrideDomainOrgUnit <bool>]
 [-OverrideHighAvailability <bool>] [-OverrideSize <bool>] [-PreCreatedHosts <uint>]
 [-RemoveServersAfterDrainAndPowerOff <bool>] [-ServersToAddPerRequest <uint>] [-TemplateId <uint>]
 [-TemplateTagId <uint>] [-TemplateVersionId <uint>] [-ValidationEnvironment <bool>]
 [-VMSize <string>] [-WorkLoadDrain <uint>] [-WorkloadThreshold <uint>] [<CommonParameters>]
```

```powershell
New-RASAVDHostPool [-Name] <string> [[-SiteId] <uint>]
 -LoadBalancerType {BreadthFirst | DepthFirst | Persistent} -Location <string>
 -PoolType {Pooled | Personal} -ProvisioningType {Template | Standalone}
 -PublishingType {RemoteApp | Desktop} -ResourceGroup <string> -WorkspaceId <uint>
 [-AutoScaleEnabled <bool>]
 [-AvailabilityOptions {NoInfrastructure | AvailabilitySet | AvailabilityZone}]
 [-AvailabilityPreferredZone {Zone1 | Zone2 | Zone3}]
 [-DefaultPowerState {PoweredOn | PoweredOff | Suspended}] [-DeployLocation {Standard | Hybrid}]
 [-Description <string>] [-DomainOrgUnit <string>] [-DrainRemainsBelowSec <uint>] [-Duration <uint>]
 [-Enabled <bool>] [-FriendlyName <string>] [-HostName <string>] [-HostsToCreate <uint>]
 [-HybridHostPoolId <uint>] [-LimitHosts <uint>] [-MaxHosts <uint>] [-MaxServersFromTemplate <uint>]
 [-MinServersFromTemplate <uint>] [-OverrideDomainOrgUnit <bool>] [-OverrideHighAvailability <bool>]
 [-OverrideSize <bool>] [-PowerOnHost <bool>] [-PreCreatedHosts <uint>]
 [-RemoveServersAfterDrainAndPowerOff <bool>] [-ServersToAddPerRequest <uint>] [-TemplateId <uint>]
 [-TemplateTagId <uint>] [-TemplateVersionId <uint>] [-ValidationEnvironment <bool>]
 [-VMSize <string>] [-WorkLoadDrain <uint>] [-WorkloadThreshold <uint>] [<CommonParameters>]
```

## DESCRIPTION

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

## EXAMPLES

### Example 1

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

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

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

## PARAMETERS

### -Name

The name of the AVD Host Pool.

```yaml
Type: string
Required: True
Position: 0
Default value: None
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.

```yaml
Type: uint
Required: False
Position: 1
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -WorkspaceId

The Workspace ID.

```yaml
Type: uint
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -Description

Description of the AVD Host Pool.

```yaml
Type: string
Required: False
Position: Named
Default value: None
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.

```yaml
Type: bool
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -FriendlyName

Friendly name of the AVD Host Pool.

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ResourceGroup

Resource Group of the AVD Host Pool.

```yaml
Type: string
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Location

Location of the AVD Host Pool.

```yaml
Type: string
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AzureId

The Azure ID of the AVD Host Pool.

```yaml
Type: string
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PoolType

The Pool Type of the AVD Host Pool.

Possible values: Pooled, Personal

Type reference: [PoolType](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/pooltype.md)

```yaml
Type: PoolType
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).

Available to Pooled Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: 50
Accept pipeline input: False
Accept wildcard characters: False
```

### -PublishingType

The Publishing Type of the AVD Host Pool.

Possible values: RemoteApp, Desktop

Type reference: [PublishingType](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/publishingtype.md)

```yaml
Type: PublishingType
Required: True
Position: Named
Default value: RemoteApp
Accept pipeline input: False
Accept wildcard characters: False
```

### -LoadBalancerType

The Load Balancer Type of the AVD Host Pool.

Possible values: BreadthFirst, DepthFirst, Persistent

Type reference: [LoadBalancerType](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/loadbalancertype.md)

```yaml
Type: LoadBalancerType
Required: True
Position: Named
Default value: BreadthFirst
Accept pipeline input: False
Accept wildcard characters: False
```

### -PowerOnHost

Whether Power On Host is Enabled or not.

```yaml
Type: bool
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -ValidationEnvironment

Whether Validation Environment is Enabled or not.

```yaml
Type: bool
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -ProvisioningType

The Provisioning Type of the Host Pool

Possible values: Template, Standalone

Type reference: [ProvisioningType](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/provisioningtype.md)

```yaml
Type: ProvisioningType
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -TemplateId

The Template ID.

Available to Templated Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -TemplateVersionId

The Template Version ID.

Available to Templated Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -TemplateTagId

The Template Tag ID.

Available to Templated Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MaxHosts

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

Available to Templated Personal Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PreCreatedHosts

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

Available to Templated Personal Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Duration

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

Available to Templated Personal Host Pools

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HostsToCreate

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

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AutoScaleEnabled

Whether AutoScale is Enabled or not

Available to Templated Pooled Host Pools

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MinServersFromTemplate

The Minimum Number of Hosts added from the template.

Default: 1

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MaxServersFromTemplate

The Maximum Number of Hosts added from the template.

Default: 2

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WorkloadThreshold

The Workload Threshold.

Default: 75

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ServersToAddPerRequest

The amount of servers to add per request.

Default: 1

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WorkLoadDrain

The Drain Workload.

Default: 20

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DrainRemainsBelowSec

The Remaining Drain level.

Default: 1 (Immediate)

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RemoveServersAfterDrainAndPowerOff

Remove hosts from host pool after drain and power off.

```yaml
Type: bool
Required: False
Position: Named
Default value: None
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.

```yaml
Type: string
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DefaultPowerState

The Default Power State

Possible values: PoweredOn, PoweredOff, Suspended

Type reference: [DefaultPowerState](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/defaultpowerstate.md)

```yaml
Type: DefaultPowerState
Required: False
Position: Named
Default value: PoweredOn
Accept pipeline input: False
Accept wildcard characters: False
```

### -OverrideSize

Whether Override Size is Enabled or not.

Available to Templated Host Pools

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -VMSize

VMSize which will override the size specified in template properties.

Example: Standard\_B2s

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -OverrideDomainOrgUnit

Specifications: Whether Override Domain Org Unit is Enabled or not. (OverrideDomainOrgUnit)

```yaml
Type: bool
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DomainOrgUnit

Domain Organization unit

```yaml
Type: string
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -OverrideHighAvailability

Whether to override high availability options.

```yaml
Type: bool
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -AvailabilityOptions

Availability Options.

Possible values: NoInfrastructure, AvailabilitySet, AvailabilityZone

Type reference: [HighAvailability](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/highavailability.md)

```yaml
Type: HighAvailability
Required: False
Position: Named
Default value: NoInfrastructure
Accept pipeline input: False
Accept wildcard characters: False
```

### -AvailabilityPreferredZone

Availability Preferred Zone.

Possible values: Zone1, Zone2, Zone3

Type reference: [PreferredZone](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/preferredzone.md)

```yaml
Type: PreferredZone
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -DeployLocation

Specifies the deploy location type.

Possible values: Standard, Hybrid

Type reference: [DeployLocation](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/deploylocation.md)

```yaml
Type: DeployLocation
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -HybridHostPoolId

On-premises host pool ID to link when deploy location is Hybrid.

```yaml
Type: uint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### None

## OUTPUTS

### [AVDHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/avdhostpool.md)

## RELATED LINKS

* [Get-RASAVDHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rasavdhostpool.md)
* [Set-RASAVDHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-rasavdhostpool.md)
* [Remove-RASAVDHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/remove-rasavdhostpool.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/new-rasavdhostpool.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
