Template

PreviousVHDLocations NextEnterMaintenance

Was this helpful?

Get

get

Retrieve settings of a RAS Template.

Path parameters

idinteger · int32required

The ID of a RAS Template for which to retrieve the information.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/RDS/Template/{id}'

200

401

404

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-03T07:01:31.247Z",
  "timeLastMod": "2025-04-03T07:01:31.247Z",
  "objType": [
    "89 = AVDTemplate",
    "101 = RDSTemplate",
    "102 = VDITemplate"
  ],
  "name": "text",
  "siteId": 1,
  "description": "text",
  "providerId": 1,
  "templateType": [
    "0 = SingleSession",
    "1 = MultiSession"
  ],
  "vmId": "text",
  "cloneMethod": [
    "0 = FullClone",
    "1 = LinkedClone"
  ],
  "advanced": {
    "folder": {
      "folderName": "text",
      "folderId": "text",
      "subFolderName": "text"
    },
    "nativePool": {
      "nativePoolId": "text",
      "nativePoolName": "text",
      "hwgpu": true
    },
    "physicalHost": {
      "physicalHostId": "text",
      "physicalHostName": "text"
    },
    "multipleNIC": {
      "useSeperateNetworkInterface": true,
      "address": "text",
      "subnetMask": "text"
    },
    "aws": {
      "instanceType": "text",
      "storageDevices": [
        {
          "deviceName": "text",
          "volumeType": [
            "0 = gp2",
            "1 = gp3",
            "2 = io1",
            "3 = io2",
            "4 = standard"
          ],
          "size": 1,
          "maximumIOPS": 1,
          "throughput": 1
        }
      ]
    },
    "azure": {
      "resourceGroup": "text",
      "location": "text",
      "vmSize": "text",
      "osDiskType": [
        "1 = StandardHDD",
        "2 = StandardSSD",
        "4 = PremiumSSD"
      ],
      "virtualNetworkID": "text",
      "virtualNetworkName": "text",
      "subnet": {
        "subnetID": "text",
        "subnetName": "text"
      }
    }
  },
  "preparation": {
    "imagePrepTool": [
      "0 = SysPrep",
      "1 = RASPrep"
    ],
    "computerName": "text",
    "ownerName": "text",
    "organization": "text",
    "administrator": "text",
    "domain": "text",
    "domainOrgUnit": "text"
  },
  "inheritDefaultOptimizationSettings": true,
  "optimization": {
    "enableOptimization": true,
    "optimizationType": [
      "0 = Automatic",
      "1 = Manual"
    ],
    "windowsDefenderATP": {
      "winDefATPTurnOffOn": [
        "0 = TurnOffWindowsDefenderATP",
        "1 = TurnOnWindowsDefenderATP"
      ],
      "disableRealTimeProtection": true,
      "excludeFolders": [
        "text"
      ],
      "excludeProcesses": [
        "text"
      ],
      "excludeExtension": [
        "text"
      ]
    },
    "windowsComponents": {
      "windowsComponentsList": [
        {
          "type": [
            "0 = Predefined",
            "1 = Custom"
          ],
          "componentName": "text",
          "displayName": "text",
          "aliases": "text"
        }
      ]
    },
    "windowsDefenderATPEnabled": true,
    "windowsComponentsEnabled": true,
    "windowsServicesEnabled": true,
    "windowsScheduledTasksEnabled": true,
    "windowsAdvancedOptionsEnabled": true,
    "networkPerformanceEnabled": true,
    "registryEnabled": true,
    "visualEffectsEnabled": true,
    "diskCleanupEnabled": true,
    "customScriptEnabled": true,
    "windowsServices": {
      "windowsServicesList": [
        {
          "type": [
            "0 = Predefined",
            "1 = Custom"
          ],
          "serviceName": "text",
          "displayName": "text",
          "aliases": "text"
        }
      ]
    },
    "windowsAdvancedOptions": {
      "partialStartLayoutContent": "text",
      "hibernate": true,
      "teleCollection": true,
      "systemRestore": true,
      "additionalErrorReport": true,
      "tiles": true,
      "cortana": true,
      "microsoftConsumerExperience": true,
      "windowsTips": true,
      "commonProgramGroups": true,
      "partialStartMenu": true
    },
    "networkPerformance": {
      "dirCacheMax": 1,
      "dormantFileLimit": 1,
      "fileNotFoundCache": 1,
      "fileInfoCache": 1,
      "fileInfoCacheEnable": true,
      "directoryCacheEnable": true,
      "fileNotFoundCacheEnable": true,
      "dormantFileLimitEnable": true,
      "disableTCP": true,
      "disableIPv6CompEnable": true,
      "disableIPv6ToIPv4": true,
      "disableIsaTap": true
    },
    "customScript": {
      "arguments": "text",
      "command": "text",
      "initDir": "text",
      "user": "text"
    },
    "diskCleanup": {
      "cleanupWinSxSFolder": true,
      "cleanupSystemFiles": true,
      "cleanupTemporaryFileLogs": true,
      "removeOneDrive": true,
      "deleteUserProfiles": true
    },
    "visualEffects": {
      "visualEffectsTypes": [
        "0 = LetWindowsChooseWhatsBest",
        "1 = AdjustForBestAppearance",
        "2 = AdjustForBestPerformance",
        "3 = Custom"
      ],
      "animateControlSelectElements": true,
      "animateWindowsWhenMinimizingMaximizing": true,
      "animateTaskbar": true,
      "enablePeek": true,
      "fadeSlideMenus": true,
      "fadeSlideToolTips": true,
      "fadeOutMenuItems": true,
      "saveTaskbarThumbnail": true,
      "showShadowUnderMouse": true,
      "shadowUnderWindows": true,
      "thumbnailsInsteadOfIcons": true,
      "showTranslucentSelection": true,
      "showWindowsContentWhilstDragging": true,
      "slideOpenComboBoxes": true,
      "smoothEdgesScreenFonts": true,
      "smoothScrollListBoxes": true,
      "dropShadowsIcon": true
    },
    "windowsScheduledTasks": {
      "windowsScheduledTasksList": [
        {
          "task": "text",
          "location": "text",
          "type": [
            "0 = Folder",
            "1 = Task"
          ]
        }
      ]
    },
    "registry": {
      "registryList": [
        {
          "id": 1,
          "action": [
            "0 = Add",
            "1 = Modify",
            "2 = Delete"
          ],
          "registryName": "text",
          "dwordValue": 1,
          "displayName": "text",
          "hiveType": [
            "0 = HKEY_CURRENT_CONFIG",
            "1 = HKEY_USERS",
            "2 = HKEY_LOCAL_MACHINE",
            "3 = HKEY_CLASSES_ROOT"
          ],
          "path": "text",
          "regType": [
            "0 = REG_SZ",
            "1 = REG_DWORD",
            "2 = REG_QWORD",
            "3 = REG_MULTI_SZ",
            "4 = REG_EXPAND_SZ"
          ],
          "stringValue": "text"
        }
      ]
    },
    "uwpApps": {
      "allExcept": [
        "text"
      ],
      "followingPkgs": [
        "text"
      ],
      "removeType": [
        "0 = AllExcept",
        "1 = FollowingPkgs"
      ]
    }
  },
  "licenseKeys": {
    "licenseKeyType": [
      "0 = KMS",
      "1 = MAK"
    ],
    "keys": [
      {
        "licenseKey": "text",
        "keyLimit": 1
      }
    ]
  }
}

Success

Delete

delete

Remove settings of a RAS Template.

Path parameters

idinteger · int32required

The ID of a RAS Template for which to retrieve the information.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/RDS/Template/{id}'

204

401

404

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-03T07:01:31.247Z",
  "timeLastMod": "2025-04-03T07:01:31.247Z",
  "objType": [
    "89 = AVDTemplate",
    "101 = RDSTemplate",
    "102 = VDITemplate"
  ],
  "name": "text",
  "siteId": 1,
  "description": "text",
  "providerId": 1,
  "templateType": [
    "0 = SingleSession",
    "1 = MultiSession"
  ],
  "vmId": "text",
  "cloneMethod": [
    "0 = FullClone",
    "1 = LinkedClone"
  ],
  "advanced": {
    "folder": {
      "folderName": "text",
      "folderId": "text",
      "subFolderName": "text"
    },
    "nativePool": {
      "nativePoolId": "text",
      "nativePoolName": "text",
      "hwgpu": true
    },
    "physicalHost": {
      "physicalHostId": "text",
      "physicalHostName": "text"
    },
    "multipleNIC": {
      "useSeperateNetworkInterface": true,
      "address": "text",
      "subnetMask": "text"
    },
    "aws": {
      "instanceType": "text",
      "storageDevices": [
        {
          "deviceName": "text",
          "volumeType": [
            "0 = gp2",
            "1 = gp3",
            "2 = io1",
            "3 = io2",
            "4 = standard"
          ],
          "size": 1,
          "maximumIOPS": 1,
          "throughput": 1
        }
      ]
    },
    "azure": {
      "resourceGroup": "text",
      "location": "text",
      "vmSize": "text",
      "osDiskType": [
        "1 = StandardHDD",
        "2 = StandardSSD",
        "4 = PremiumSSD"
      ],
      "virtualNetworkID": "text",
      "virtualNetworkName": "text",
      "subnet": {
        "subnetID": "text",
        "subnetName": "text"
      }
    }
  },
  "preparation": {
    "imagePrepTool": [
      "0 = SysPrep",
      "1 = RASPrep"
    ],
    "computerName": "text",
    "ownerName": "text",
    "organization": "text",
    "administrator": "text",
    "domain": "text",
    "domainOrgUnit": "text"
  },
  "inheritDefaultOptimizationSettings": true,
  "optimization": {
    "enableOptimization": true,
    "optimizationType": [
      "0 = Automatic",
      "1 = Manual"
    ],
    "windowsDefenderATP": {
      "winDefATPTurnOffOn": [
        "0 = TurnOffWindowsDefenderATP",
        "1 = TurnOnWindowsDefenderATP"
      ],
      "disableRealTimeProtection": true,
      "excludeFolders": [
        "text"
      ],
      "excludeProcesses": [
        "text"
      ],
      "excludeExtension": [
        "text"
      ]
    },
    "windowsComponents": {
      "windowsComponentsList": [
        {
          "type": [
            "0 = Predefined",
            "1 = Custom"
          ],
          "componentName": "text",
          "displayName": "text",
          "aliases": "text"
        }
      ]
    },
    "windowsDefenderATPEnabled": true,
    "windowsComponentsEnabled": true,
    "windowsServicesEnabled": true,
    "windowsScheduledTasksEnabled": true,
    "windowsAdvancedOptionsEnabled": true,
    "networkPerformanceEnabled": true,
    "registryEnabled": true,
    "visualEffectsEnabled": true,
    "diskCleanupEnabled": true,
    "customScriptEnabled": true,
    "windowsServices": {
      "windowsServicesList": [
        {
          "type": [
            "0 = Predefined",
            "1 = Custom"
          ],
          "serviceName": "text",
          "displayName": "text",
          "aliases": "text"
        }
      ]
    },
    "windowsAdvancedOptions": {
      "partialStartLayoutContent": "text",
      "hibernate": true,
      "teleCollection": true,
      "systemRestore": true,
      "additionalErrorReport": true,
      "tiles": true,
      "cortana": true,
      "microsoftConsumerExperience": true,
      "windowsTips": true,
      "commonProgramGroups": true,
      "partialStartMenu": true
    },
    "networkPerformance": {
      "dirCacheMax": 1,
      "dormantFileLimit": 1,
      "fileNotFoundCache": 1,
      "fileInfoCache": 1,
      "fileInfoCacheEnable": true,
      "directoryCacheEnable": true,
      "fileNotFoundCacheEnable": true,
      "dormantFileLimitEnable": true,
      "disableTCP": true,
      "disableIPv6CompEnable": true,
      "disableIPv6ToIPv4": true,
      "disableIsaTap": true
    },
    "customScript": {
      "arguments": "text",
      "command": "text",
      "initDir": "text",
      "user": "text"
    },
    "diskCleanup": {
      "cleanupWinSxSFolder": true,
      "cleanupSystemFiles": true,
      "cleanupTemporaryFileLogs": true,
      "removeOneDrive": true,
      "deleteUserProfiles": true
    },
    "visualEffects": {
      "visualEffectsTypes": [
        "0 = LetWindowsChooseWhatsBest",
        "1 = AdjustForBestAppearance",
        "2 = AdjustForBestPerformance",
        "3 = Custom"
      ],
      "animateControlSelectElements": true,
      "animateWindowsWhenMinimizingMaximizing": true,
      "animateTaskbar": true,
      "enablePeek": true,
      "fadeSlideMenus": true,
      "fadeSlideToolTips": true,
      "fadeOutMenuItems": true,
      "saveTaskbarThumbnail": true,
      "showShadowUnderMouse": true,
      "shadowUnderWindows": true,
      "thumbnailsInsteadOfIcons": true,
      "showTranslucentSelection": true,
      "showWindowsContentWhilstDragging": true,
      "slideOpenComboBoxes": true,
      "smoothEdgesScreenFonts": true,
      "smoothScrollListBoxes": true,
      "dropShadowsIcon": true
    },
    "windowsScheduledTasks": {
      "windowsScheduledTasksList": [
        {
          "task": "text",
          "location": "text",
          "type": [
            "0 = Folder",
            "1 = Task"
          ]
        }
      ]
    },
    "registry": {
      "registryList": [
        {
          "id": 1,
          "action": [
            "0 = Add",
            "1 = Modify",
            "2 = Delete"
          ],
          "registryName": "text",
          "dwordValue": 1,
          "displayName": "text",
          "hiveType": [
            "0 = HKEY_CURRENT_CONFIG",
            "1 = HKEY_USERS",
            "2 = HKEY_LOCAL_MACHINE",
            "3 = HKEY_CLASSES_ROOT"
          ],
          "path": "text",
          "regType": [
            "0 = REG_SZ",
            "1 = REG_DWORD",
            "2 = REG_QWORD",
            "3 = REG_MULTI_SZ",
            "4 = REG_EXPAND_SZ"
          ],
          "stringValue": "text"
        }
      ]
    },
    "uwpApps": {
      "allExcept": [
        "text"
      ],
      "followingPkgs": [
        "text"
      ],
      "removeType": [
        "0 = AllExcept",
        "1 = FollowingPkgs"
      ]
    }
  },
  "licenseKeys": {
    "licenseKeyType": [
      "0 = KMS",
      "1 = MAK"
    ],
    "keys": [
      {
        "licenseKey": "text",
        "keyLimit": 1
      }
    ]
  }
}

No Content

List

get

Retrieve settings about RAS Templates.

Query parameters

SiteIdinteger · int32optional

The site ID from which to retrieve the RAS Template info (optional).

Namestringoptional

RAS Template name.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/RDS/Template'

200

401

404

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-04-03T07:01:31.247Z",
    "timeLastMod": "2025-04-03T07:01:31.247Z",
    "objType": [
      "89 = AVDTemplate",
      "101 = RDSTemplate",
      "102 = VDITemplate"
    ],
    "name": "text",
    "siteId": 1,
    "description": "text",
    "providerId": 1,
    "templateType": [
      "0 = SingleSession",
      "1 = MultiSession"
    ],
    "vmId": "text",
    "cloneMethod": [
      "0 = FullClone",
      "1 = LinkedClone"
    ],
    "advanced": {
      "folder": {
        "folderName": "text",
        "folderId": "text",
        "subFolderName": "text"
      },
      "nativePool": {
        "nativePoolId": "text",
        "nativePoolName": "text",
        "hwgpu": true
      },
      "physicalHost": {
        "physicalHostId": "text",
        "physicalHostName": "text"
      },
      "multipleNIC": {
        "useSeperateNetworkInterface": true,
        "address": "text",
        "subnetMask": "text"
      },
      "aws": {
        "instanceType": "text",
        "storageDevices": [
          {
            "deviceName": "text",
            "volumeType": [
              "0 = gp2",
              "1 = gp3",
              "2 = io1",
              "3 = io2",
              "4 = standard"
            ],
            "size": 1,
            "maximumIOPS": 1,
            "throughput": 1
          }
        ]
      },
      "azure": {
        "resourceGroup": "text",
        "location": "text",
        "vmSize": "text",
        "osDiskType": [
          "1 = StandardHDD",
          "2 = StandardSSD",
          "4 = PremiumSSD"
        ],
        "virtualNetworkID": "text",
        "virtualNetworkName": "text",
        "subnet": {
          "subnetID": "text",
          "subnetName": "text"
        }
      }
    },
    "preparation": {
      "imagePrepTool": [
        "0 = SysPrep",
        "1 = RASPrep"
      ],
      "computerName": "text",
      "ownerName": "text",
      "organization": "text",
      "administrator": "text",
      "domain": "text",
      "domainOrgUnit": "text"
    },
    "inheritDefaultOptimizationSettings": true,
    "optimization": {
      "enableOptimization": true,
      "optimizationType": [
        "0 = Automatic",
        "1 = Manual"
      ],
      "windowsDefenderATP": {
        "winDefATPTurnOffOn": [
          "0 = TurnOffWindowsDefenderATP",
          "1 = TurnOnWindowsDefenderATP"
        ],
        "disableRealTimeProtection": true,
        "excludeFolders": [
          "text"
        ],
        "excludeProcesses": [
          "text"
        ],
        "excludeExtension": [
          "text"
        ]
      },
      "windowsComponents": {
        "windowsComponentsList": [
          {
            "type": [
              "0 = Predefined",
              "1 = Custom"
            ],
            "componentName": "text",
            "displayName": "text",
            "aliases": "text"
          }
        ]
      },
      "windowsDefenderATPEnabled": true,
      "windowsComponentsEnabled": true,
      "windowsServicesEnabled": true,
      "windowsScheduledTasksEnabled": true,
      "windowsAdvancedOptionsEnabled": true,
      "networkPerformanceEnabled": true,
      "registryEnabled": true,
      "visualEffectsEnabled": true,
      "diskCleanupEnabled": true,
      "customScriptEnabled": true,
      "windowsServices": {
        "windowsServicesList": [
          {
            "type": [
              "0 = Predefined",
              "1 = Custom"
            ],
            "serviceName": "text",
            "displayName": "text",
            "aliases": "text"
          }
        ]
      },
      "windowsAdvancedOptions": {
        "partialStartLayoutContent": "text",
        "hibernate": true,
        "teleCollection": true,
        "systemRestore": true,
        "additionalErrorReport": true,
        "tiles": true,
        "cortana": true,
        "microsoftConsumerExperience": true,
        "windowsTips": true,
        "commonProgramGroups": true,
        "partialStartMenu": true
      },
      "networkPerformance": {
        "dirCacheMax": 1,
        "dormantFileLimit": 1,
        "fileNotFoundCache": 1,
        "fileInfoCache": 1,
        "fileInfoCacheEnable": true,
        "directoryCacheEnable": true,
        "fileNotFoundCacheEnable": true,
        "dormantFileLimitEnable": true,
        "disableTCP": true,
        "disableIPv6CompEnable": true,
        "disableIPv6ToIPv4": true,
        "disableIsaTap": true
      },
      "customScript": {
        "arguments": "text",
        "command": "text",
        "initDir": "text",
        "user": "text"
      },
      "diskCleanup": {
        "cleanupWinSxSFolder": true,
        "cleanupSystemFiles": true,
        "cleanupTemporaryFileLogs": true,
        "removeOneDrive": true,
        "deleteUserProfiles": true
      },
      "visualEffects": {
        "visualEffectsTypes": [
          "0 = LetWindowsChooseWhatsBest",
          "1 = AdjustForBestAppearance",
          "2 = AdjustForBestPerformance",
          "3 = Custom"
        ],
        "animateControlSelectElements": true,
        "animateWindowsWhenMinimizingMaximizing": true,
        "animateTaskbar": true,
        "enablePeek": true,
        "fadeSlideMenus": true,
        "fadeSlideToolTips": true,
        "fadeOutMenuItems": true,
        "saveTaskbarThumbnail": true,
        "showShadowUnderMouse": true,
        "shadowUnderWindows": true,
        "thumbnailsInsteadOfIcons": true,
        "showTranslucentSelection": true,
        "showWindowsContentWhilstDragging": true,
        "slideOpenComboBoxes": true,
        "smoothEdgesScreenFonts": true,
        "smoothScrollListBoxes": true,
        "dropShadowsIcon": true
      },
      "windowsScheduledTasks": {
        "windowsScheduledTasksList": [
          {
            "task": "text",
            "location": "text",
            "type": [
              "0 = Folder",
              "1 = Task"
            ]
          }
        ]
      },
      "registry": {
        "registryList": [
          {
            "id": 1,
            "action": [
              "0 = Add",
              "1 = Modify",
              "2 = Delete"
            ],
            "registryName": "text",
            "dwordValue": 1,
            "displayName": "text",
            "hiveType": [
              "0 = HKEY_CURRENT_CONFIG",
              "1 = HKEY_USERS",
              "2 = HKEY_LOCAL_MACHINE",
              "3 = HKEY_CLASSES_ROOT"
            ],
            "path": "text",
            "regType": [
              "0 = REG_SZ",
              "1 = REG_DWORD",
              "2 = REG_QWORD",
              "3 = REG_MULTI_SZ",
              "4 = REG_EXPAND_SZ"
            ],
            "stringValue": "text"
          }
        ]
      },
      "uwpApps": {
        "allExcept": [
          "text"
        ],
        "followingPkgs": [
          "text"
        ],
        "removeType": [
          "0 = AllExcept",
          "1 = FollowingPkgs"
        ]
      }
    },
    "licenseKeys": {
      "licenseKeyType": [
        "0 = KMS",
        "1 = MAK"
      ],
      "keys": [
        {
          "licenseKey": "text",
          "keyLimit": 1
        }
      ]
    }
  }
]

Success

Create

post

Creates a new RAS Template.

Body

providerIdinteger · int32required

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

vmIdstring | nullablerequired

The ID of the source VM.

namestring | nullableoptional

RAS Template Name.

siteIdinteger · int32optional

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.

descriptionstring | nullableoptional

RAS Template Description.

templateTypestring · enumoptional

Host Session Type

Available options:

cloneMethodstring · enumoptional

Clone Method

Available options:

folderNamestring | nullableoptional

Folder name where desktop VMs will be created.

folderIdstring | nullableoptional

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

subFolderNamestring | nullableoptional

Subfolder name where desktop VMs will be created.

nativePoolIdstring | nullableoptional

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

nativePoolNamestring | nullableoptional

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

hwgpubooleanoptional

Enable hardware acceleration graphics licensing support.

physicalHostIdstring | nullableoptional

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

physicalHostNamestring | nullableoptional

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

useSeperateNetworkInterfacebooleanoptional

Use a separate network interface for LAN access.

addressstring | nullableoptional

The address of the network interface.

subnetMaskstring | nullableoptional

The subnet mask of the network interface.

instanceTypestring | nullableoptional

Instance type.

deviceNamestring | nullableoptional

Device name.

volumeTypestring · enumoptional

Volume type

Available options:

sizeinteger · int32optional

Size (GiB).

maximumIOPSinteger · int64 | nullableoptional

Maximum IOPS.

throughputinteger · int64 | nullableoptional

Throughput (MB/s).

resourceGroupstring | nullableoptional

Resource group.

vmSizestring | nullableoptional

VM size.

osDiskTypestring · enumoptional

Volume type

Available options:

virtualNetworkIDstring | nullableoptional

Virtual network ID.

virtualNetworkNamestring | nullableoptional

Virtual network name.

subnetIDstring | nullableoptional

Subnet ID.

subnetNamestring | nullableoptional

Subnet name.

imagePrepToolstring · enumoptional

Image preparation tool

Available options:

computerNamestring | nullableoptional

The FQDN or IP address of the target VM.

ownerNamestring | nullableoptional

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

organizationstring | nullableoptional

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

domainstring | nullablerequired

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

domainPasswordstring | nullablerequired

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

administratorstring | nullablerequired

The administrator of the domain specified in the JoinDomain parameter.

adminPasswordstring | nullablerequired

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

domainOrgUnitstring | nullableoptional

Domain Organization unit

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/RDS/Template' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "providerId": 1,
    "vmId": "text",
    "name": "text",
    "siteId": 1,
    "description": "text",
    "templateType": [
      "0 = SingleSession",
      "1 = MultiSession"
    ],
    "cloneMethod": [
      "0 = FullClone",
      "1 = LinkedClone"
    ],
    "folderName": "text",
    "folderId": "text",
    "subFolderName": "text",
    "nativePoolId": "text",
    "nativePoolName": "text",
    "hwgpu": true,
    "physicalHostId": "text",
    "physicalHostName": "text",
    "useSeperateNetworkInterface": true,
    "address": "text",
    "subnetMask": "text",
    "instanceType": "text",
    "deviceName": "text",
    "volumeType": [
      "0 = gp2",
      "1 = gp3",
      "2 = io1",
      "3 = io2",
      "4 = standard"
    ],
    "size": 1,
    "maximumIOPS": 1,
    "throughput": 1,
    "resourceGroup": "text",
    "vmSize": "text",
    "osDiskType": [
      "1 = StandardHDD",
      "2 = StandardSSD",
      "4 = PremiumSSD"
    ],
    "virtualNetworkID": "text",
    "virtualNetworkName": "text",
    "subnetID": "text",
    "subnetName": "text",
    "imagePrepTool": [
      "0 = SysPrep",
      "1 = RASPrep"
    ],
    "computerName": "text",
    "ownerName": "text",
    "organization": "text",
    "domain": "text",
    "domainPassword": "text",
    "administrator": "text",
    "adminPassword": "text",
    "domainOrgUnit": "text"
  }'

201

401

409

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-03T07:01:31.247Z",
  "timeLastMod": "2025-04-03T07:01:31.247Z",
  "objType": [
    "89 = AVDTemplate",
    "101 = RDSTemplate",
    "102 = VDITemplate"
  ],
  "name": "text",
  "siteId": 1,
  "description": "text",
  "providerId": 1,
  "templateType": [
    "0 = SingleSession",
    "1 = MultiSession"
  ],
  "vmId": "text",
  "cloneMethod": [
    "0 = FullClone",
    "1 = LinkedClone"
  ],
  "advanced": {
    "folder": {
      "folderName": "text",
      "folderId": "text",
      "subFolderName": "text"
    },
    "nativePool": {
      "nativePoolId": "text",
      "nativePoolName": "text",
      "hwgpu": true
    },
    "physicalHost": {
      "physicalHostId": "text",
      "physicalHostName": "text"
    },
    "multipleNIC": {
      "useSeperateNetworkInterface": true,
      "address": "text",
      "subnetMask": "text"
    },
    "aws": {
      "instanceType": "text",
      "storageDevices": [
        {
          "deviceName": "text",
          "volumeType": [
            "0 = gp2",
            "1 = gp3",
            "2 = io1",
            "3 = io2",
            "4 = standard"
          ],
          "size": 1,
          "maximumIOPS": 1,
          "throughput": 1
        }
      ]
    },
    "azure": {
      "resourceGroup": "text",
      "location": "text",
      "vmSize": "text",
      "osDiskType": [
        "1 = StandardHDD",
        "2 = StandardSSD",
        "4 = PremiumSSD"
      ],
      "virtualNetworkID": "text",
      "virtualNetworkName": "text",
      "subnet": {
        "subnetID": "text",
        "subnetName": "text"
      }
    }
  },
  "preparation": {
    "imagePrepTool": [
      "0 = SysPrep",
      "1 = RASPrep"
    ],
    "computerName": "text",
    "ownerName": "text",
    "organization": "text",
    "administrator": "text",
    "domain": "text",
    "domainOrgUnit": "text"
  },
  "inheritDefaultOptimizationSettings": true,
  "optimization": {
    "enableOptimization": true,
    "optimizationType": [
      "0 = Automatic",
      "1 = Manual"
    ],
    "windowsDefenderATP": {
      "winDefATPTurnOffOn": [
        "0 = TurnOffWindowsDefenderATP",
        "1 = TurnOnWindowsDefenderATP"
      ],
      "disableRealTimeProtection": true,
      "excludeFolders": [
        "text"
      ],
      "excludeProcesses": [
        "text"
      ],
      "excludeExtension": [
        "text"
      ]
    },
    "windowsComponents": {
      "windowsComponentsList": [
        {
          "type": [
            "0 = Predefined",
            "1 = Custom"
          ],
          "componentName": "text",
          "displayName": "text",
          "aliases": "text"
        }
      ]
    },
    "windowsDefenderATPEnabled": true,
    "windowsComponentsEnabled": true,
    "windowsServicesEnabled": true,
    "windowsScheduledTasksEnabled": true,
    "windowsAdvancedOptionsEnabled": true,
    "networkPerformanceEnabled": true,
    "registryEnabled": true,
    "visualEffectsEnabled": true,
    "diskCleanupEnabled": true,
    "customScriptEnabled": true,
    "windowsServices": {
      "windowsServicesList": [
        {
          "type": [
            "0 = Predefined",
            "1 = Custom"
          ],
          "serviceName": "text",
          "displayName": "text",
          "aliases": "text"
        }
      ]
    },
    "windowsAdvancedOptions": {
      "partialStartLayoutContent": "text",
      "hibernate": true,
      "teleCollection": true,
      "systemRestore": true,
      "additionalErrorReport": true,
      "tiles": true,
      "cortana": true,
      "microsoftConsumerExperience": true,
      "windowsTips": true,
      "commonProgramGroups": true,
      "partialStartMenu": true
    },
    "networkPerformance": {
      "dirCacheMax": 1,
      "dormantFileLimit": 1,
      "fileNotFoundCache": 1,
      "fileInfoCache": 1,
      "fileInfoCacheEnable": true,
      "directoryCacheEnable": true,
      "fileNotFoundCacheEnable": true,
      "dormantFileLimitEnable": true,
      "disableTCP": true,
      "disableIPv6CompEnable": true,
      "disableIPv6ToIPv4": true,
      "disableIsaTap": true
    },
    "customScript": {
      "arguments": "text",
      "command": "text",
      "initDir": "text",
      "user": "text"
    },
    "diskCleanup": {
      "cleanupWinSxSFolder": true,
      "cleanupSystemFiles": true,
      "cleanupTemporaryFileLogs": true,
      "removeOneDrive": true,
      "deleteUserProfiles": true
    },
    "visualEffects": {
      "visualEffectsTypes": [
        "0 = LetWindowsChooseWhatsBest",
        "1 = AdjustForBestAppearance",
        "2 = AdjustForBestPerformance",
        "3 = Custom"
      ],
      "animateControlSelectElements": true,
      "animateWindowsWhenMinimizingMaximizing": true,
      "animateTaskbar": true,
      "enablePeek": true,
      "fadeSlideMenus": true,
      "fadeSlideToolTips": true,
      "fadeOutMenuItems": true,
      "saveTaskbarThumbnail": true,
      "showShadowUnderMouse": true,
      "shadowUnderWindows": true,
      "thumbnailsInsteadOfIcons": true,
      "showTranslucentSelection": true,
      "showWindowsContentWhilstDragging": true,
      "slideOpenComboBoxes": true,
      "smoothEdgesScreenFonts": true,
      "smoothScrollListBoxes": true,
      "dropShadowsIcon": true
    },
    "windowsScheduledTasks": {
      "windowsScheduledTasksList": [
        {
          "task": "text",
          "location": "text",
          "type": [
            "0 = Folder",
            "1 = Task"
          ]
        }
      ]
    },
    "registry": {
      "registryList": [
        {
          "id": 1,
          "action": [
            "0 = Add",
            "1 = Modify",
            "2 = Delete"
          ],
          "registryName": "text",
          "dwordValue": 1,
          "displayName": "text",
          "hiveType": [
            "0 = HKEY_CURRENT_CONFIG",
            "1 = HKEY_USERS",
            "2 = HKEY_LOCAL_MACHINE",
            "3 = HKEY_CLASSES_ROOT"
          ],
          "path": "text",
          "regType": [
            "0 = REG_SZ",
            "1 = REG_DWORD",
            "2 = REG_QWORD",
            "3 = REG_MULTI_SZ",
            "4 = REG_EXPAND_SZ"
          ],
          "stringValue": "text"
        }
      ]
    },
    "uwpApps": {
      "allExcept": [
        "text"
      ],
      "followingPkgs": [
        "text"
      ],
      "removeType": [
        "0 = AllExcept",
        "1 = FollowingPkgs"
      ]
    }
  },
  "licenseKeys": {
    "licenseKeyType": [
      "0 = KMS",
      "1 = MAK"
    ],
    "keys": [
      {
        "licenseKey": "text",
        "keyLimit": 1
      }
    ]
  }
}

Created

Update

put

Modifies the settings of a RAS Template.

Path parameters

idinteger · int32required

The ID of a RAS Template to modify.

Body

descriptionstring | nullableoptional

RAS Template Description.

folderNamestring | nullableoptional

Folder name where desktop VMs will be created.

folderIdstring | nullableoptional

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

subFolderNamestring | nullableoptional

Subfolder name where desktop VMs will be created.

nativePoolIdstring | nullableoptional

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

nativePoolNamestring | nullableoptional

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

hwgpuboolean | nullableoptional

Enable hardware acceleration graphics licensing support.

physicalHostIdstring | nullableoptional

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

physicalHostNamestring | nullableoptional

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

useSeperateNetworkInterfaceboolean | nullableoptional

Use a separate network interface for LAN access.

addressstring | nullableoptional

The address of the network interface.

subnetMaskstring | nullableoptional

The subnet mask of the network interface.

instanceTypestring | nullableoptional

Instance type.

deviceNamestring | nullableoptional

Device name.

volumeTypestring · enumoptional

Volume type

Available options:

sizeinteger · int64 | nullableoptional

Size (GiB).

maximumIOPSinteger · int64 | nullableoptional

Maximum IOPS.

throughputinteger · int64 | nullableoptional

Throughput (MB/s).

resourceGroupstring | nullableoptional

Resource group.

vmSizestring | nullableoptional

VM size.

osDiskTypestring · enumoptional

Volume type

Available options:

virtualNetworkIDstring | nullableoptional

Virtual network ID.

virtualNetworkNamestring | nullableoptional

Virtual network name.

subnetIDstring | nullableoptional

Subnet ID.

subnetNamestring | nullableoptional

Subnet name.

imagePrepToolstring · enumoptional

Image preparation tool

Available options:

computerNamestring | nullableoptional

The FQDN or IP address of the target VM.

ownerNamestring | nullableoptional

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

organizationstring | nullableoptional

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

domainstring | nullableoptional

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

domainPasswordstring | nullableoptional

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

administratorstring | nullableoptional

The administrator of the domain specified in the JoinDomain parameter.

adminPasswordstring | nullableoptional

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

domainOrgUnitstring | nullableoptional

Domain Organization unit

inheritDefaultOptimizationSettingsboolean | nullableoptional

If true, default Optimization settings will be inherited.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/RDS/Template/{id}' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "description": "text",
    "folderName": "text",
    "folderId": "text",
    "subFolderName": "text",
    "nativePoolId": "text",
    "nativePoolName": "text",
    "hwgpu": true,
    "physicalHostId": "text",
    "physicalHostName": "text",
    "useSeperateNetworkInterface": true,
    "address": "text",
    "subnetMask": "text",
    "instanceType": "text",
    "deviceName": "text",
    "volumeType": [
      "0 = gp2",
      "1 = gp3",
      "2 = io1",
      "3 = io2",
      "4 = standard"
    ],
    "size": 1,
    "maximumIOPS": 1,
    "throughput": 1,
    "resourceGroup": "text",
    "vmSize": "text",
    "osDiskType": [
      "1 = StandardHDD",
      "2 = StandardSSD",
      "4 = PremiumSSD"
    ],
    "virtualNetworkID": "text",
    "virtualNetworkName": "text",
    "subnetID": "text",
    "subnetName": "text",
    "imagePrepTool": [
      "0 = SysPrep",
      "1 = RASPrep"
    ],
    "computerName": "text",
    "ownerName": "text",
    "organization": "text",
    "domain": "text",
    "domainPassword": "text",
    "administrator": "text",
    "adminPassword": "text",
    "domainOrgUnit": "text",
    "inheritDefaultOptimizationSettings": true
  }'

204

401

404

No body

No Content