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

# Set-RASTemplate

## SYNOPSIS

Modifies a Template property.

## SYNTAX

```powershell
Set-RASTemplate [-Id] <uint> -ObjType {RDSTemplate | VDITemplate | AVDTemplate} [-Address <string>]
 [-Administrator <string>] [-AdminPassword <SecureString>] [-ClusterId <string>]
 [-ClusterName <string>] [-ComputerName <string>] [-DatastoreIDs <string[]>]
 [-DatastoreSource {Template | Selection}] [-Description <string>] [-DeviceName <string>]
 [-Domain <string>] [-DomainOrgUnit <string>] [-DomainPassword <SecureString>] [-FolderId <string>]
 [-FolderName <string>] [-HWGPU <bool>] [-ImagePrepTool {SysPrep | RASPrep}]
 [-InheritDefaultOptimizationSettings <bool>] [-InstanceType <string>] [-MaximumIOPS <ulong>]
 [-NativePoolId <string>] [-NativePoolName <string>] [-NewName <string>] [-Organization <string>]
 [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>]
 [-PhysicalHostId <string>] [-PhysicalHostName <string>] [-ResourceGroup <string>] [-Size <ulong>]
 [-SubFolderName <string>] [-SubnetId <string>] [-SubnetMask <string>] [-SubnetName <string>]
 [-Throughput <ulong>] [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>]
 [-VirtualNetworkName <string>] [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}]
 [<CommonParameters>]
```

```powershell
Set-RASTemplate [-InputObject] <Template> -ObjType {RDSTemplate | VDITemplate | AVDTemplate}
 [-Address <string>] [-Administrator <string>] [-AdminPassword <SecureString>] [-ClusterId <string>]
 [-ClusterName <string>] [-ComputerName <string>] [-DatastoreIDs <string[]>]
 [-DatastoreSource {Template | Selection}] [-Description <string>] [-DeviceName <string>]
 [-Domain <string>] [-DomainOrgUnit <string>] [-DomainPassword <SecureString>] [-FolderId <string>]
 [-FolderName <string>] [-HWGPU <bool>] [-ImagePrepTool {SysPrep | RASPrep}]
 [-InheritDefaultOptimizationSettings <bool>] [-InstanceType <string>] [-MaximumIOPS <ulong>]
 [-NativePoolId <string>] [-NativePoolName <string>] [-NewName <string>] [-Organization <string>]
 [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>]
 [-PhysicalHostId <string>] [-PhysicalHostName <string>] [-ResourceGroup <string>] [-Size <ulong>]
 [-SubFolderName <string>] [-SubnetId <string>] [-SubnetMask <string>] [-SubnetName <string>]
 [-Throughput <ulong>] [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>]
 [-VirtualNetworkName <string>] [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}]
 [<CommonParameters>]
```

```powershell
Set-RASTemplate [-Name] <string> [[-SiteId] <uint>]
 -ObjType {RDSTemplate | VDITemplate | AVDTemplate} [-Address <string>] [-Administrator <string>]
 [-AdminPassword <SecureString>] [-ClusterId <string>] [-ClusterName <string>]
 [-ComputerName <string>] [-DatastoreIDs <string[]>] [-DatastoreSource {Template | Selection}]
 [-Description <string>] [-DeviceName <string>] [-Domain <string>] [-DomainOrgUnit <string>]
 [-DomainPassword <SecureString>] [-FolderId <string>] [-FolderName <string>] [-HWGPU <bool>]
 [-ImagePrepTool {SysPrep | RASPrep}] [-InheritDefaultOptimizationSettings <bool>]
 [-InstanceType <string>] [-MaximumIOPS <ulong>] [-NativePoolId <string>] [-NativePoolName <string>]
 [-NewName <string>] [-Organization <string>] [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}]
 [-OwnerName <string>] [-PhysicalHostId <string>] [-PhysicalHostName <string>]
 [-ResourceGroup <string>] [-Size <ulong>] [-SubFolderName <string>] [-SubnetId <string>]
 [-SubnetMask <string>] [-SubnetName <string>] [-Throughput <ulong>]
 [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>] [-VirtualNetworkName <string>]
 [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}] [<CommonParameters>]
```

## DESCRIPTION

The cmdlet modifies a Template property.

## EXAMPLES

### Example 1

```powershell
Set-RASTemplate -ObjType RDSTemplate -Name "My Template" | Format-List
```

Modifies the RDS Template properties specified by name from the Licensing Server site.

### Example 2

```powershell
Set-RASTemplate -ObjType VDITemplate -Id 10
```

Modifies VDI Template specified by ID from the Licensing Server site.

## PARAMETERS

### -Name

The name of the RAS Template to modify.

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

### -SiteId

The site ID to which the RAS Template belongs.

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

### -Id

The ID of a RAS Template to modify.

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

### -InputObject

An object of type Template representing the target RAS Template info.

To obtain the object, use the Get-RASTemplate command."

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

```yaml
Type: Template
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: [Template](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/template.md)

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

### -NewName

RAS Template Name.

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

### -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: None
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: None
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: ulong
Required: False
Position: Named
Default value: None
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: False
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.

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

### -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: None
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: False
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: False
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: False
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: 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
```

### -DatastoreSource

Datastore Source.

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.

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

### -InheritDefaultOptimizationSettings

If true, default Optimization settings will be inherited.

```yaml
Type: bool
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

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

## OUTPUTS

### None

## RELATED LINKS

* [New-RASTemplate](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/new-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/set-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.
