# New-RASVDIHostPool

## NAME

New-RASVDIHostPool

## SYNOPSIS

Creates a new VDI Host Pool.

## SYNTAX

**New-RASVDIHostPool** \[-[Name](#Name)] _\<string>_ \[\[-[SiteId](#SiteId)] _\<uint>_] -[ProvisioningType](#ProvisioningType) {Template | Standalone} \[-[DefaultPowerState](#DefaultPowerState) {PoweredOn | PoweredOff | Suspended}] \[-[Description](#Description) _\<string>_] \[-[Duration](#Duration) _\<uint>_] \[-[Enabled](#Enabled) _\<bool>_] \[-[HostName](#HostName) _\<string>_] \[-[HostsToCreate](#HostsToCreate) _\<uint>_] \[-[MaxHosts](#MaxHosts) _\<uint>_] \[-[PreCreatedHosts](#PreCreatedHosts) _\<uint>_] \[-[TemplateId](#TemplateId) _\<uint>_] \[-[TemplateVersionId](#TemplateVersionId) _\<uint>_] \[_<_[_CommonParameters_](#CommonParameters)_>_]

## DESCRIPTION

Creates a new VDI Host Pool. Individual members can be added to the VDI host pool using the Add-RASVDIHostPoolMember cmdlet.

## PARAMETERS

-**Name \<string>**\
The name of the target VDI Host Pool.

This must be the actual VDI Host Pool name used in the RAS farm.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**SiteId \<uint>**\
Site ID in which to modify the specified VDI 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
```

-**Description \<string>**\
A user-defined VDI Host Pool description.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**Enabled \<bool>**\
Enable or disable the VDI Host Pool upon creation.

If the parameter is omitted, the VDI Host Pool is initialised as Disabled.

```
        Required?                    false

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**ProvisioningType <**[**ProvisioningType**](../classes-and-enumerations/provisioningtype)**>**\
The Host Pool Provisioning type

Possible values: Template, Standalone

```
        Required?                    true

        Position?                    named

        Default value                Template

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**TemplateId \<uint>**\
Template ID

```
        Required?                    false

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**TemplateVersionId \<uint>**\
Template Version ID

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

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**PreCreatedHosts \<uint>**\
The maximum pre-created hosts.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**HostName \<string>**\
The VM 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**](../classes-and-enumerations/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
```

-**Duration \<uint>**\
The Duration

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

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

[VDIHostPool](../classes-and-enumerations/vdihostpool)

## EXAMPLES

**---------- EXAMPLE 1 ----------**

New-RASVDIHostPool "My VDI Host Pool"

Creates a new VDI Host Pool with the specified name.

## RELATED LINKS

* [Get-RASVDIHostPool](get-rasvdihostpool)
* [Set-RASVDIHostPool](set-rasvdihostpool)
* [Remove-RASVDIHostPool](remove-rasvdihostpool)
* [Add-RASVDIHostPoolMember](add-rasvdihostpoolmember)
* [Remove-RASVDIHostPoolMember](remove-rasvdihostpoolmember)
