# New-RASAVDHost

## NAME

New-RASAVDHost

## SYNOPSIS

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

## SYNTAX

**New-RASAVDHost** \[\[-[SiteId](#siteid-string)]\*\* *(uint)*] -[AzureId](#azureid-string) *(string)* -[HostPoolId](#hostpoolid-string) *(uint)* \[*(*[*CommonParameters*](#CommonParameters)*)*]

**New-RASAVDHost** \[\[-[SiteId](#siteid-string)]\*\* *(uint)*] -[HostPoolId](#hostpoolid-string) *(uint)* -[NumberOfHosts](#numberofhosts-string) *(uint)* \[*(*[*CommonParameters*](#CommonParameters)*)*]

## DESCRIPTION

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

## PARAMETERS

## HostPoolId (uint)

Host Pool Id of the AVD Host.

```
        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## NumberOfHosts (uint)

Number of Hosts to create from template.

```
        Required?                    true

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## AzureId (string)

The Azure Host ID of the AVD Host.

Found as Resource ID in Azure.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SiteId (uint)

Site ID from which to retrieve the AVD Host information.

If the parameter is omitted, the Licensing Server site ID will be used.

```
        Required?                    false

        Position?                    1

        Default value                0

        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

-none-

## EXAMPLES

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

New-RASAVDHost -HostPoolID 1 -AzureID "/subscriptions/b64739563-74S9-849s-ks94-89sa5nbj83oe/resourceGroups/My-Resource-Group/providers/Microsoft.Compute/virtualMachines/My-Virtual-Machine"

Creates an AVD Host from a Standalone AVD Pool.\
\&#xNAN;**---------- EXAMPLE 2 ----------**

New-RASAVDHost -HostPoolID 1 -NumberOfHosts 2 -SiteID 1

Creates AVD Hosts from a Templated AVD Host Pool.

## RELATED LINKS

* [Get-RASAVDHost](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/get-rasavdhost)
* [Remove-RASAVDHost](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/remove-rasavdhost)
* [Invoke-RASAVDHost](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/invoke-rasavdhost)