> 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-rastemplate.md).

# New-RASTemplate

## SYNOPSIS

Creates a Template.

## SYNTAX

```powershell
New-RASTemplate [-ProviderId] <uint> [-AzureId] <string> -Administrator <string>
 -AdminPassword <SecureString> -CustomHost <SwitchParameter> -Domain <string>
 -DomainPassword <SecureString> -ObjType {RDSTemplate | VDITemplate | AVDTemplate}
 -TemplateType {SingleSession | MultiSession} [-Address <string>]
 [-AvailabilityOptions {NoInfrastructure | AvailabilitySet | AvailabilityZone}]
 [-AvailabilityPreferredZone {Zone1 | Zone2 | Zone3}] [-CloneMethod {FullClone | LinkedClone}]
 [-ClusterId <string>] [-ClusterName <string>] [-ComputerName <string>] [-DatastoreIDs <string[]>]
 [-DatastoreSource {Template | Selection}] [-Description <string>] [-DeviceName <string>]
 [-DomainOrgUnit <string>] [-EnableSecureBoot <bool>] [-EnableVTPM <bool>] [-FolderId <string>]
 [-FolderName <string>] [-HibernationEnabled <bool>] [-HWGPU <bool>]
 [-ImagePrepTool {SysPrep | RASPrep}] [-InstanceType <string>] [-IntegrityMonitoring <bool>]
 [-MaximumIOPS <ulong>] [-Name <string>] [-NativePoolId <string>] [-NativePoolName <string>]
 [-NoAllowRemoteConnections <SwitchParameter>] [-NoApplyParallelsPowerPlan <SwitchParameter>]
 [-NoFireWallRules <SwitchParameter>] [-NoRestart <SwitchParameter>] [-Organization <string>]
 [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>]
 [-Password <SecureString>] [-PhysicalHostId <string>] [-PhysicalHostName <string>]
 [-ResourceGroup <string>] [-SiteId <uint>] [-Size <uint>] [-SubFolderName <string>]
 [-SubnetId <string>] [-SubnetMask <string>] [-SubnetName <string>] [-Throughput <ulong>]
 [-Username <string>] [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>]
 [-VirtualNetworkName <string>] [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}]
 [<CommonParameters>]
```

```powershell
New-RASTemplate [-ProviderId] <uint> [-AzureId] <string> -Administrator <string>
 -AdminPassword <SecureString> -AzureGallery <SwitchParameter> -Domain <string>
 -DomainPassword <SecureString> -LocalAdminPassword <SecureString> -LocalAdminUsername <string>
 -Location <string> -Name <string> -ObjType {RDSTemplate | VDITemplate | AVDTemplate}
 -OSDiskType {StandardHDD | StandardSSD | PremiumSSD} -ResourceGroup <string> -SubnetName <string>
 -TemplateType {SingleSession | MultiSession} -VirtualNetworkName <string> [-Address <string>]
 [-AvailabilityOptions {NoInfrastructure | AvailabilitySet | AvailabilityZone}]
 [-AvailabilityPreferredZone {Zone1 | Zone2 | Zone3}] [-CloneMethod {FullClone | LinkedClone}]
 [-ClusterId <string>] [-ClusterName <string>] [-ComputerName <string>] [-DatastoreIDs <string[]>]
 [-DatastoreSource {Template | Selection}] [-Description <string>] [-DeviceName <string>]
 [-DomainOrgUnit <string>] [-EnableSecureBoot <bool>] [-EnableVTPM <bool>] [-FolderId <string>]
 [-FolderName <string>] [-GalleryName <string>] [-HibernationEnabled <bool>] [-HWGPU <bool>]
 [-ImagePrepTool {SysPrep | RASPrep}] [-InstanceType <string>] [-IntegrityMonitoring <bool>]
 [-MaximumIOPS <ulong>] [-NativePoolId <string>] [-NativePoolName <string>]
 [-NoAllowRemoteConnections <SwitchParameter>] [-NoApplyParallelsPowerPlan <SwitchParameter>]
 [-NoFireWallRules <SwitchParameter>] [-NoRestart <SwitchParameter>] [-Organization <string>]
 [-OwnerName <string>] [-Password <SecureString>] [-PhysicalHostId <string>]
 [-PhysicalHostName <string>] [-SecurityType {TrustedLaunch | Standard}] [-SiteId <uint>]
 [-Size <uint>] [-SubFolderName <string>] [-SubnetId <string>] [-SubnetMask <string>]
 [-Throughput <ulong>] [-Username <string>] [-UseSeperateNetworkInterface <bool>]
 [-VirtualNetworkID <string>] [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}]
 [<CommonParameters>]
```

```powershell
New-RASTemplate [-ProviderId] <uint> [-VMId] <string> -Administrator <string>
 -AdminPassword <SecureString> -Domain <string> -DomainPassword <SecureString>
 -ObjType {RDSTemplate | VDITemplate | AVDTemplate} [-Address <string>]
 [-AvailabilityOptions {NoInfrastructure | AvailabilitySet | AvailabilityZone}]
 [-AvailabilityPreferredZone {Zone1 | Zone2 | Zone3}] [-CloneMethod {FullClone | LinkedClone}]
 [-ClusterId <string>] [-ClusterName <string>] [-ComputerName <string>] [-DatastoreIDs <string[]>]
 [-DatastoreSource {Template | Selection}] [-Description <string>] [-DeviceName <string>]
 [-DomainOrgUnit <string>] [-EnableSecureBoot <bool>] [-EnableVTPM <bool>] [-FolderId <string>]
 [-FolderName <string>] [-HibernationEnabled <bool>] [-HWGPU <bool>]
 [-ImagePrepTool {SysPrep | RASPrep}] [-InstanceType <string>] [-IntegrityMonitoring <bool>]
 [-MaximumIOPS <ulong>] [-Name <string>] [-NativePoolId <string>] [-NativePoolName <string>]
 [-NoAllowRemoteConnections <SwitchParameter>] [-NoApplyParallelsPowerPlan <SwitchParameter>]
 [-NoDesktopExperience <SwitchParameter>] [-NoFireWallRules <SwitchParameter>]
 [-NoRestart <SwitchParameter>] [-NoTerminalServices <SwitchParameter>] [-Organization <string>]
 [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>]
 [-Password <SecureString>] [-PhysicalHostId <string>] [-PhysicalHostName <string>]
 [-ResourceGroup <string>] [-SiteId <uint>] [-Size <uint>] [-SubFolderName <string>]
 [-SubnetId <string>] [-SubnetMask <string>] [-SubnetName <string>]
 [-TemplateType {SingleSession | MultiSession}] [-Throughput <ulong>] [-Username <string>]
 [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>] [-VirtualNetworkName <string>]
 [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}] [<CommonParameters>]
```

```powershell
New-RASTemplate [-InputObject] <VM> -Administrator <string> -AdminPassword <SecureString>
 -Domain <string> -DomainPassword <SecureString> -ObjType {RDSTemplate | VDITemplate | AVDTemplate}
 [-Address <string>] [-AvailabilityOptions {NoInfrastructure | AvailabilitySet | AvailabilityZone}]
 [-AvailabilityPreferredZone {Zone1 | Zone2 | Zone3}] [-CloneMethod {FullClone | LinkedClone}]
 [-ClusterId <string>] [-ClusterName <string>] [-ComputerName <string>] [-DatastoreIDs <string[]>]
 [-DatastoreSource {Template | Selection}] [-Description <string>] [-DeviceName <string>]
 [-DomainOrgUnit <string>] [-EnableSecureBoot <bool>] [-EnableVTPM <bool>] [-FolderId <string>]
 [-FolderName <string>] [-HibernationEnabled <bool>] [-HWGPU <bool>]
 [-ImagePrepTool {SysPrep | RASPrep}] [-InstanceType <string>] [-IntegrityMonitoring <bool>]
 [-MaximumIOPS <ulong>] [-Name <string>] [-NativePoolId <string>] [-NativePoolName <string>]
 [-NoAllowRemoteConnections <SwitchParameter>] [-NoApplyParallelsPowerPlan <SwitchParameter>]
 [-NoDesktopExperience <SwitchParameter>] [-NoFireWallRules <SwitchParameter>]
 [-NoRestart <SwitchParameter>] [-NoTerminalServices <SwitchParameter>] [-Organization <string>]
 [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>]
 [-Password <SecureString>] [-PhysicalHostId <string>] [-PhysicalHostName <string>]
 [-ResourceGroup <string>] [-SiteId <uint>] [-Size <uint>] [-SubFolderName <string>]
 [-SubnetId <string>] [-SubnetMask <string>] [-SubnetName <string>]
 [-TemplateType {SingleSession | MultiSession}] [-Throughput <ulong>] [-Username <string>]
 [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>] [-VirtualNetworkName <string>]
 [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}] [<CommonParameters>]
```

## DESCRIPTION

The cmdlet creates a Template.

## EXAMPLES

### Example 1

```powershell
New-RASTemplate -ObjType VDITemplate -Name "My Template" -ProviderId 1 Domain "my domain" -DomainPassword $password -Administrator "admin" -AdminPassword $password
```

Creates an VDI Template with the specified data.

### Example 2

```powershell
New-RASTemplate -ObjType AVDTemplate -Name "My Template" -AzureGallery -ProviderId 1 -Domain "my domain" -DomainPassword $password -Administrator "admin" -AdminPassword $password -TemplateType SingleSession -OSDiskType StandardSSD -ResourceGroup "my Resource Group" -location "westeurope" -VirtualNetworkName "vnet" -SubnetName "subnet" -LocalAdminUsername "admin" -LocalAdminPassword $password -AzureId "/subscriptions/j383475632498-93h5-034f-le09-768ds6f78987sd3/resourceGroups/myResourceGourp/providers/Microsoft.Compute/galleries/myGallery/images/myImage"
```

Creates an AVD Template based on the specified AVD Gallery Image.

### Example 3

```powershell
New-RASTemplate -ObjType AVDTemplate -Name "My Template" -CustomHost -ProviderId 1 -Domain "my domain" -DomainPassword $password -Administrator "admin" -AdminPassword $password -AzureId "/subscriptions/j383475632498-93h5-034f-le09-768ds6f78987sd3/resourceGroups/myResourceGourp/providers/Microsoft.Compute/virtualMachines/myMachine"
```

Creates an AVD Template based on the specified AVD Custom Host.

## PARAMETERS

### -ProviderId

The ID of a Provider on which the source desktop VM resides.

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

### -VMId

The ID of the source VM.

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

### -InputObject

The desktop VM to be converted to a RAS Template.

To obtain an object of type VDIDesktop representing the VM, use the Get-VM or Get-VDIDesktop cmdlet.

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

```yaml
Type: VM
Required: True
Position: 0
Default value: None
Accept pipeline input: true (ByValue)
Accept wildcard characters: False
```

### -ObjType

Template object type.

Possible values: RDSTemplate, VDITemplate, AVDTemplate

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

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

### -Name

RAS Template Name.

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

### -SiteId

The site ID in which to create the RAS Template info.

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

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

### -Description

RAS Template Description.

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

### -TemplateType

Template type: Single Session (VDI / AVD) or Multi Session (RDS / AVD (default))

Possible values: SingleSession, MultiSession

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

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

### -CloneMethod

Clone method: Full clone (default) or Linked clone (Not supported for RDS/VDI - Azure/AWS).

Possible values: FullClone, LinkedClone

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

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

### -Username

An administrator account for push installing the RD Session Host agent on the server.

If this parameter is omitted, your RAS admin username (and password) will be used.

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

### -Password

The password of the account specified in the Username parameter.

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

### -NoRestart

Specifies not to restart the server after the RD Session Host agent is installed.

If this parameter is omitted, the server will be restarted if required.

This parameter applies only for RDSH Templates.

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

### -NoFireWallRules

Specifies not to add firewall rules to allow the RAS Guest Agent to communicate.

If this parameter is omitted, the firewall rules will not be added.

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

### -NoAllowRemoteConnections

Specifies not to enable allow remote connection when the RAS Guest Agent is installed.

If this parameter is omitted, remote connections are enabled.

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

### -NoApplyParallelsPowerPlan

Specifies not to apply Parallels power plan when the RAS Guest Agent is installed.

If this parameter is omitted, the plan will be applied.

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

### -FolderName

Folder name where desktop VMs will be created.

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

### -FolderId

The ID of a folder where desktop VMs will be created.

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

### -SubFolderName

Subfolder name where desktop VMs will be created.

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

### -NativePoolId

The ID of the native pool where desktop VMs will be created.

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

### -NativePoolName

The name of the native pool where desktop VMs will be created.

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

### -HWGPU

Enable hardware acceleration graphics licensing support.

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

### -PhysicalHostId

The ID of a physical host where desktop VMs will be created.

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

### -PhysicalHostName

The name of a physical host where desktop VMs will be created.

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

### -UseSeperateNetworkInterface

Use a separate network interface for LAN access.

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

### -Address

The address of the network interface.

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

### -SubnetMask

The subnet mask of the network interface.

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

### -InstanceType

Instance type.

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

### -DeviceName

Device name.

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

### -VolumeType

Volume type.

Possible values: gp2, gp3, io1, io2, standard

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

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

### -Size

Size (GiB).

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

### -MaximumIOPS

Maximum IOPS.

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

### -Throughput

Throughput (MB/s).

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

### -ResourceGroup

Resource group.

Available to VDI/RDS Templates Azure and AVD Templates.

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

### -VMSize

VM size.

Available to VDI/RDS Templates Azure and AVD Templates. Default: Standard\_B2s

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

### -OSDiskType

OS disk type.

Available to VDI/RDS Templates Azure and AVD Templates.

Possible values: StandardHDD, StandardSSD, PremiumSSD

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

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

### -VirtualNetworkID

Virtual network ID.

Available to VDI/RDS Templates Azure and AVD Templates.

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

### -VirtualNetworkName

Virtual network name.

Available to VDI/RDS Templates Azure and AVD Templates.

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

Acceptable values: Zone 1, Zone 2, Zone 3

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

### -SubnetId

Subnet Id.

Available to VDI/RDS Templates Azure/NutanixPC and AVD Templates.

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

### -SubnetName

Subnet name.

Available to VDI/RDS Templates Azure/NutanixPC and AVD Templates.

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

### -ClusterName

Cluster name where desktop VMs will be created.

Available to VDI/RDS Templates NutanixPC.

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

### -ClusterId

The ID of a cluster where desktop VMs will be created.

Available to VDI/RDS Templates NutanixPC.

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

### -DatastoreSource

Datastore Source.

Available to VDI/RDS Templates VCenter.

Possible values: Template, Selection

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

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

### -DatastoreIDs

Datastore IDs.

Available to VDI/RDS Templates VCenter.

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

### -SecurityType

Security Type.

Available to AVD Azure Gallery Templates.

Possible values: TrustedLaunch, Standard

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

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

### -EnableSecureBoot

Specifies if 'Enable secure boot' option is enabled or disabled.

Available to VDI/RDS Azure/AVD Templates, when security type is Trusted Launch.

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

### -EnableVTPM

Specifies if 'Enable vTPM' option is enabled or disabled.

Available to VDI/RDS Azure/AVD Templates, when security type is Trusted Launch.

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

### -IntegrityMonitoring

Specifies if 'Integrity monitoring' option is enabled or disabled.

Available to VDI/RDS Azure/AVD Templates, when security type is Trusted Launch.

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

### -HibernationEnabled

Specifies if 'Hibernation' option is enabled or disabled.

Available to Azure/AVD Templates.

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

### -ImagePrepTool

Image preparation tool: RASPrep (default) or SysPrep.

Possible values: SysPrep, RASPrep

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

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

### -ComputerName

The FQDN or IP address of the target VM.

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

### -OwnerName

A desktop VM owner name (assigned to a VM by RASprep or Sysprep).

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

### -Organization

Organization name (assigned to a VM by RASprep or Sysprep).

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

### -Domain

Domain or WorkGroup to join (assigned to a VM by RASprep or Sysprep).

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

### -DomainPassword

The password of the domain administrator specified in the Administrator parameter.

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

### -Administrator

The administrator of the domain specified in the JoinDomain parameter.

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

### -AdminPassword

The password of the administrator for the desktop VM (assigned to a VM by RASprep or Sysprep).

```yaml
Type: SecureString
Required: True
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
```

### -NoDesktopExperience

Specifies not to install the Desktop Experience after the RD Session Host agent is installed.

If this parameter is omitted, the Desktop Experience is installed.

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

### -NoTerminalServices

Specifies not to install the Terminal Services role after the RD Session Host agent is installed.

If this parameter is omitted, the Terminal Services role will be installed.

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

### -AzureId

The Azure ID of the AVD Custom Host or AVD Gallery Image.

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

### -CustomHost

Specifies that the AVD Template will use an AVD Custom Host.

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

### -AzureGallery

Specifies that the AVD Template will use an AVD Gallery Image.

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

### -GalleryName

The name of the AVD Gallery that contains the AVD Gallery Image.

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

### -Location

The AVD Location of the AVD Gallery Image.

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

### -LocalAdminUsername

The local admin username.

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

### -LocalAdminPassword

The local admin password.

```yaml
Type: SecureString
Required: True
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

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

## OUTPUTS

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

## RELATED LINKS

* [Set-RASTemplate](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-rastemplate.md)
* [Remove-RASTemplate](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/remove-rastemplate.md)
* [Get-RASTemplate](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rastemplate.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-rastemplate.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.
