HostPool

List

get

Retrieve a list of the RD Session Host Pools

Query parameters
SiteIdinteger · int32Optional

Site ID for which to retrieve the RD Session Host Pools (optional)

NamestringOptional

Filter the result by name (optional)

Responses
200

Success

application/json; api-version=1.0
get
GET /api/RDS/HostPool HTTP/1.1
Host: 
Accept: */*
[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-08-29T23:41:17.335Z",
    "timeLastMod": "2025-08-29T23:41:17.335Z",
    "name": "text",
    "siteId": 1,
    "enabled": true,
    "description": "text",
    "autoscale": true,
    "rasTemplateId": 1,
    "rasTemplateVersionId": 1,
    "minServersFromTemplate": 1,
    "maxServersFromTemplate": 1,
    "workLoadThreshold": 1,
    "serversToAddPerRequest": 1,
    "workLoadToDrain": 1,
    "drainRemainsBelowSec": 1,
    "removeServersAfterDrainAndPowerOff": true,
    "inheritDefaultAgentSettings": true,
    "inheritDefaultPrinterSettings": true,
    "inheritDefaultUserProfileSettings": true,
    "inheritDefaultDesktopAccessSettings": true,
    "inheritDefaultAppPackageSettings": true,
    "inheritDefaultAutoUpgradeSettings": true,
    "rdsDefSettings": {
      "port": 1,
      "maxSessions": 1,
      "disconnectActiveSessionAfter": 1,
      "logoffDisconnectedSessionAfter": 1,
      "allowURLAndMailRedirection": [
        "0 = Disabled",
        "1 = Enabled",
        "2 = EnabledWithAppRegistration"
      ],
      "supportShellURLNamespaceObjects": true,
      "preferredBrokerId": 1,
      "enableDriveRedirectionCache": true,
      "allowRemoteExec": true,
      "enableAppMonitoring": true,
      "useRemoteApps": true,
      "allowFileTransfer": true,
      "fileTransferMode": [
        "0 = Disabled",
        "1 = ClientToServer",
        "2 = ServerToClient",
        "3 = Bidirectional"
      ],
      "fileTransferLocation": "text",
      "fileTransferLockLocation": true,
      "allowDragAndDrop": true,
      "dragAndDropMode": [
        "0 = Disabled",
        "1 = ClientToServer",
        "2 = ServerToClient",
        "3 = Bidirectional"
      ],
      "manageRDPTransportProtocol": [
        "0 = Disabled",
        "1 = BothUDPTCP",
        "2 = OnlyTCP",
        "3 = EitherUDPTCP"
      ],
      "printerNameFormat": [
        "0 = PrnFormat_PRN_CMP_SES",
        "1 = PrnFormat_SES_CMP_PRN",
        "2 = PrnFormat_PRN_REDSES"
      ],
      "removeClientNameFromPrinterName": true,
      "removeSessionNumberFromPrinterName": true,
      "technology": [
        "0 = DoNotManage",
        "1 = UPD",
        "2 = FSLogix"
      ],
      "fsLogix": {
        "profileContainer": {
          "enabled": true,
          "locationType": [
            "0 = SMBLocation",
            "1 = CloudCache"
          ],
          "vhdLocations": [
            "text"
          ],
          "ccdLocations": [
            "text"
          ],
          "profileDiskFormat": [
            "0 = VHD",
            "1 = VHDX"
          ],
          "allocationType": [
            "0 = Dynamic",
            "1 = Full"
          ],
          "defaultSize": 1,
          "userInclusionList": [
            {
              "account": "text",
              "type": [
                "1 = User",
                "2 = Group",
                "3 = ForeignSecurityPrincipal",
                "4 = Computer"
              ],
              "sid": "text"
            }
          ],
          "userExclusionList": [
            {
              "account": "text",
              "type": [
                "1 = User",
                "2 = Group",
                "3 = ForeignSecurityPrincipal",
                "4 = Computer"
              ],
              "sid": "text"
            }
          ],
          "cloudCache": {
            "useMaxCacheSizeInMBs": true,
            "maxCacheSizeInMBs": 1,
            "useClearCacheOnLogoff": true,
            "clearCacheOnLogoff": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useHealthyProvidersRequiredForRegister": true,
            "healthyProvidersRequiredForRegister": 1,
            "useHealthyProvidersRequiredForUnregister": true,
            "healthyProvidersRequiredForUnregister": 1,
            "useUnregisterTimeout": true,
            "unregisterTimeout": 1,
            "useClearCacheOnForcedUnregister": true,
            "clearCacheOnForcedUnregister": [
              "0 = Disable",
              "1 = Enable"
            ]
          },
          "customizeProfileFolders": true,
          "excludeCommonFolders": [
            "1 = Contacts",
            "2 = Desktop",
            "4 = Documents",
            "8 = Links",
            "16 = MusicPodcasts",
            "32 = PicturesVideos",
            "64 = FoldersLowIntegProcesses",
            "128 = Downloads"
          ],
          "folderInclusionList": [
            "text"
          ],
          "folderExclusionList": [
            {
              "folder": "text",
              "excludeFolderCopy": [
                "0 = None",
                "1 = CopyBase",
                "2 = CopyBack"
              ]
            }
          ],
          "advancedSettings": {
            "useLockedRetryCount": true,
            "lockedRetryCount": 1,
            "useLockedRetryInterval": true,
            "lockedRetryInterval": 1,
            "useAccessNetworkAsComputerObject": true,
            "accessNetworkAsComputerObject": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useAttachVHDSDDL": true,
            "attachVHDSDDL": "text",
            "useDiffDiskParentFolderPath": true,
            "diffDiskParentFolderPath": "text",
            "useFlipFlopProfileDirectoryName": true,
            "flipFlopProfileDirectoryName": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useNoProfileContainingFolder": true,
            "noProfileContainingFolder": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useOutlookCachedMode": true,
            "outlookCachedMode": [
              "0 = Disable",
              "1 = Enable"
            ],
            "usePreventLoginWithFailure": true,
            "preventLoginWithFailure": [
              "0 = Disable",
              "1 = Enable"
            ],
            "usePreventLoginWithTempProfile": true,
            "preventLoginWithTempProfile": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useReAttachRetryCount": true,
            "reAttachRetryCount": 1,
            "useReAttachIntervalSeconds": true,
            "reAttachIntervalSeconds": 1,
            "useRemoveOrphanedOSTFilesOnLogoff": true,
            "removeOrphanedOSTFilesOnLogoff": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useRoamSearch": true,
            "roamSearch": [
              "0 = Disable",
              "1 = SingleUser",
              "2 = MultiUser"
            ],
            "useSIDDirNameMatch": true,
            "sidDirNameMatch": "text",
            "useSIDDirNamePattern": true,
            "sidDirNamePattern": "text",
            "useSIDDirSDDL": true,
            "sidDirSDDL": "text",
            "useVHDNameMatch": true,
            "vhdNameMatch": "text",
            "useVHDNamePattern": true,
            "vhdNamePattern": "text",
            "useVHDXSectorSize": true,
            "vhdxSectorSize": [
              "0 = SystemDefault",
              "512 = Size_512",
              "4096 = Size_4096"
            ],
            "useVolumeWaitTimeMS": true,
            "volumeWaitTimeMS": 1,
            "useIgnoreNonAVD": true,
            "ignoreNonAVD": [
              "0 = AnySession",
              "1 = AVDSessions"
            ],
            "useRedirectType": true,
            "redirectType": [
              "1 = Legacy",
              "2 = Advanced"
            ],
            "useKeepLocalDir": true,
            "keepLocalDir": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useDeleteLocalProfileWhenVHDShouldApply": true,
            "deleteLocalProfileWhenVHDShouldApply": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useProfileDirSDDL": true,
            "profileDirSDDL": "text",
            "useProfileType": true,
            "profileType": [
              "0 = NormalProfile",
              "1 = OnlyRWProfile",
              "2 = OnlyROProfile",
              "3 = RWROProfile"
            ],
            "useSetTempToLocalPath": true,
            "setTempToLocalPath": [
              "0 = TakeNoAction",
              "1 = RedirectTempAndTmp",
              "2 = RedirectINetCache",
              "3 = RedirectTempTmpAndINetCache"
            ],
            "useCleanOutNotifications": true,
            "cleanOutNotifications": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useInstallAppxPackages": true,
            "installAppxPackages": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useRebootOnUserLogoff": true,
            "rebootOnUserLogoff": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useRoamIdentity": true,
            "roamIdentity": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useShutdownOnUserLogoff": true,
            "shutdownOnUserLogoff": [
              "0 = Disable",
              "1 = Enable"
            ]
          }
        },
        "officeContainer": {
          "enabled": true,
          "locationType": [
            "0 = SMBLocation",
            "1 = CloudCache"
          ],
          "vhdLocations": [
            "text"
          ],
          "ccdLocations": [
            "text"
          ],
          "profileDiskFormat": [
            "0 = VHD",
            "1 = VHDX"
          ],
          "allocationType": [
            "0 = Dynamic",
            "1 = Full"
          ],
          "defaultSize": 1,
          "userInclusionList": [
            {
              "account": "text",
              "type": [
                "1 = User",
                "2 = Group",
                "3 = ForeignSecurityPrincipal",
                "4 = Computer"
              ],
              "sid": "text"
            }
          ],
          "userExclusionList": [
            {
              "account": "text",
              "type": [
                "1 = User",
                "2 = Group",
                "3 = ForeignSecurityPrincipal",
                "4 = Computer"
              ],
              "sid": "text"
            }
          ],
          "cloudCache": {
            "useMaxCacheSizeInMBs": true,
            "maxCacheSizeInMBs": 1,
            "useClearCacheOnLogoff": true,
            "clearCacheOnLogoff": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useHealthyProvidersRequiredForRegister": true,
            "healthyProvidersRequiredForRegister": 1,
            "useHealthyProvidersRequiredForUnregister": true,
            "healthyProvidersRequiredForUnregister": 1,
            "useUnregisterTimeout": true,
            "unregisterTimeout": 1,
            "useClearCacheOnForcedUnregister": true,
            "clearCacheOnForcedUnregister": [
              "0 = Disable",
              "1 = Enable"
            ]
          },
          "advancedSettings": {
            "useLockedRetryCount": true,
            "lockedRetryCount": 1,
            "useLockedRetryInterval": true,
            "lockedRetryInterval": 1,
            "useAccessNetworkAsComputerObject": true,
            "accessNetworkAsComputerObject": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useAttachVHDSDDL": true,
            "attachVHDSDDL": "text",
            "useDiffDiskParentFolderPath": true,
            "diffDiskParentFolderPath": "text",
            "useFlipFlopProfileDirectoryName": true,
            "flipFlopProfileDirectoryName": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useNoProfileContainingFolder": true,
            "noProfileContainingFolder": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useOutlookCachedMode": true,
            "outlookCachedMode": [
              "0 = Disable",
              "1 = Enable"
            ],
            "usePreventLoginWithFailure": true,
            "preventLoginWithFailure": [
              "0 = Disable",
              "1 = Enable"
            ],
            "usePreventLoginWithTempProfile": true,
            "preventLoginWithTempProfile": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useReAttachRetryCount": true,
            "reAttachRetryCount": 1,
            "useReAttachIntervalSeconds": true,
            "reAttachIntervalSeconds": 1,
            "useRemoveOrphanedOSTFilesOnLogoff": true,
            "removeOrphanedOSTFilesOnLogoff": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useRoamSearch": true,
            "roamSearch": [
              "0 = Disable",
              "1 = SingleUser",
              "2 = MultiUser"
            ],
            "useSIDDirNameMatch": true,
            "sidDirNameMatch": "text",
            "useSIDDirNamePattern": true,
            "sidDirNamePattern": "text",
            "useSIDDirSDDL": true,
            "sidDirSDDL": "text",
            "useVHDNameMatch": true,
            "vhdNameMatch": "text",
            "useVHDNamePattern": true,
            "vhdNamePattern": "text",
            "useVHDXSectorSize": true,
            "vhdxSectorSize": [
              "0 = SystemDefault",
              "512 = Size_512",
              "4096 = Size_4096"
            ],
            "useVolumeWaitTimeMS": true,
            "volumeWaitTimeMS": 1,
            "useIgnoreNonAVD": true,
            "ignoreNonAVD": [
              "0 = AnySession",
              "1 = AVDSessions"
            ],
            "useRedirectType": true,
            "redirectType": [
              "1 = Legacy",
              "2 = Advanced"
            ],
            "useIncludeOfficeActivation": true,
            "includeOfficeActivation": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeOneDrive": true,
            "includeOneDrive": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeOneNote": true,
            "includeOneNote": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeOneNoteUWP": true,
            "includeOneNoteUWP": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeOutlook": true,
            "includeOutlook": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeOutlookPersonalization": true,
            "includeOutlookPersonalization": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeSharepoint": true,
            "includeSharepoint": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeSkype": true,
            "includeSkype": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useIncludeTeams": true,
            "includeTeams": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useMirrorLocalOSTToVHD": true,
            "mirrorLocalOSTToVHD": [
              "0 = DoNothing",
              "1 = Copy",
              "2 = Move"
            ],
            "useNumSessionVHDsToKeep": true,
            "numSessionVHDsToKeep": 1,
            "useOutlookFolderPath": true,
            "outlookFolderPath": "text",
            "useRefreshUserPolicy": true,
            "refreshUserPolicy": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useVHDAccessMode": true,
            "vhdAccessMode": [
              "0 = NormalDirectAccess",
              "1 = DiffDiskNetwork",
              "2 = DiffDiskLocal",
              "3 = UniqueVHDPerSession"
            ]
          }
        },
        "generalSettings": {
          "appServices": {
            "useCleanupInvalidSessions": true,
            "cleanupInvalidSessions": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useRoamRecycleBin": true,
            "roamRecycleBin": [
              "0 = Disable",
              "1 = Enable"
            ],
            "useVHDCompactDisk": true,
            "vhdCompactDisk": [
              "0 = Disable",
              "1 = Enable"
            ]
          },
          "cloudCacheGeneral": {
            "useCacheDirectory": true,
            "cacheDirectory": "text",
            "useWriteCacheDirectory": true,
            "writeCacheDirectory": "text",
            "useProxyDirectory": true,
            "proxyDirectory": "text",
            "useSilenceACLWarning": true,
            "silenceACLWarning": [
              "0 = Disable",
              "1 = Enable"
            ]
          },
          "logging": {
            "logEnabled": [
              "0 = Disable",
              "1 = Specific",
              "2 = All"
            ],
            "logLevel": [
              "0 = Debug",
              "1 = Information",
              "2 = Warning",
              "3 = Error"
            ],
            "logFileKeepingPeriod": 1,
            "logDirectory": "text",
            "robocopyLogPath": "text",
            "logSpecificComponents": [
              "1 = ProfileConfigTool",
              "2 = IEPlugin",
              "4 = RuleEditor",
              "8 = JavaRuleEditor",
              "16 = FSLogixAgentService",
              "32 = Profile",
              "64 = JavaLauncher",
              "128 = OfficeContainer",
              "256 = RuleCompilation",
              "512 = FontVisibility",
              "1024 = Network",
              "2048 = PrinterVisibility",
              "4096 = ADSComputerGroup",
              "8192 = DriverInterface",
              "16384 = WindowsSearchRoaming",
              "32768 = WindowsSearchPlugin",
              "65536 = ProcessStartMonitor"
            ]
          }
        }
      },
      "updMode": [
        "0 = DoNotChange",
        "1 = Enabled",
        "2 = Disabled"
      ],
      "maxUserProfileDiskSizeGB": 1,
      "diskPath": "text",
      "roamingMode": [
        "0 = Exclude",
        "2 = Include"
      ],
      "includeFolderPath": [
        "text"
      ],
      "includeFilePath": [
        "text"
      ],
      "excludeFolderPath": [
        "text"
      ],
      "excludeFilePath": [
        "text"
      ],
      "restrictDesktopAccess": true,
      "restrictedUsers": [
        "text"
      ],
      "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"
          ]
        }
      },
      "appPackagesAssigned": {
        "applicationPackagesAssigned": [
          {
            "version": "text",
            "tagName": "text",
            "tagId": 1,
            "packageName": "text"
          }
        ]
      },
      "autoUpgrade": {
        "enabled": true,
        "startDateTime": "2025-08-29T23:41:17.335Z",
        "drainModeDurationInSecs": 1,
        "forceLogoffSessions": true,
        "repeat": [
          "0 = Never",
          "1 = EveryDay",
          "2 = EveryWeek",
          "3 = Every2Weeks",
          "4 = EveryMonth",
          "5 = EveryYear",
          "6 = SpecificDays"
        ],
        "specificDays": [
          "0 = Never",
          "1 = Sunday",
          "2 = Monday",
          "4 = Tuesday",
          "8 = Wednesday",
          "16 = Thursday",
          "32 = Friday",
          "64 = Saturday"
        ],
        "messages": [
          {
            "id": 1,
            "enabled": true,
            "messageTitle": "text",
            "message": "text",
            "sendMsgSecs": 1,
            "sendMsgWhen": [
              "0 = Before",
              "1 = After"
            ]
          }
        ]
      }
    },
    "rdsIds": [
      1
    ],
    "rdsProvisioningSettings": {
      "hostName": "text",
      "defaultPowerState": [
        "0 = PoweredOn",
        "1 = PoweredOff",
        "2 = Suspended"
      ]
    }
  }
]

Create

post

Create a new RD Session Host Pool

Body

Create a new RD Session Host Pool

namestring | nullableRequired

Host pool name.

siteIdinteger · int32Optional

Site ID in which to create the host pool. If the parameter is omitted, the site ID of the Licensing Server will be used.

descriptionstring | nullableOptional

A description of the specified host pool.

autoscalebooleanOptional

Enable Autoscaling.

rasTemplateIdinteger · int32 | nullableOptional

The RDSH RAS Template ID.

rasTemplateVersionIdinteger · int32 | nullableOptional

The RDSH RAS Template Version ID.

minServersFromTemplateinteger · int32Optional

Min number of servers to be added to the host pool from the RAS Template. Default: 1

maxServersFromTemplateinteger · int32Optional

Max number of servers to be added to the host pool from the RAS Template. Default: 2

hostNamestring | nullableOptional

The host name format. All hosts created from the template will have this name with %ID:N:S% replaced.

defaultPowerStatestring · enumOptional

Session Type

Possible values:
hostsToCreateinteger · int32Optional

The number of hosts that will be created after template creation process has finished. These desktops are created only once.

workLoadThresholdinteger · int32Optional

Send a request to the RAS template when the workload threshold is above the specified value. Default: 75

serversToAddPerRequestinteger · int32Optional

Number of servers to be added to the host pool per request. Default: 1

workLoadToDraininteger · int32Optional

Drain and power off servers within host pool when workload is below the specified value. Default: 20

drainRemainsBelowSecinteger · int32Optional

Drain and power off servers from host pool when workload remains below the specified level for the below specified time (in seconds). Default: 0 (Immediate)

removeServersAfterDrainAndPowerOffboolean | nullableOptional

Remove servers from host pool after drain and power off.

rdsIdsinteger · int32[] | nullableOptional

A list of RD Session Host servers (an array of RDS Ids) to add to the host pool.

inheritDefaultAgentSettingsboolean | nullableOptional

Enable or disable the 'Inherit default agent settings' option. This will inherit Global agent settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultPrinterSettingsboolean | nullableOptional

Enable or disable the 'Inherit default printer settings' option. This will inherit Global printer settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultUserProfileSettingsboolean | nullableOptional

Enable or disable the 'Inherit default user profile settings' option. This will inherit Global User Profile settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultDesktopAccessSettingsboolean | nullableOptional

Enable or disable the 'Inherit default desktop access settings' option. This will inherit Global Desktop Access settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultAutoUpgradeSettingsboolean | nullableOptional

Enable or disable the 'Inherit Auto-upgrade settings' option. This will inherit Global Auto-upgrade settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

portinteger · int32 | nullableOptional

Specifies the port number for the RD Session Host agent.

maxSessionsinteger · int32 | nullableOptional

Specifies the 'Maximum Sessions' property.

disconnectActiveSessionAfterinteger · int32 | nullableOptional

Disconnect active session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'.

logoffDisconnectedSessionAfterinteger · int32 | nullableOptional

Logoff disconnected session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'; 1 for 'Immediate'.

allowURLAndMailRedirectionstring · enumOptional

URL and Mail Redirection values.

Possible values:
supportShellURLNamespaceObjectsboolean | nullableOptional

Enable or disable the 'Support Shell URL Namespace Objects' option.

preferredBrokerIdinteger · int32 | nullableOptional

The preferred Connection Broker.

allowRemoteExecboolean | nullableOptional

Enable or disable the 'Allow 2XRemoteExec to send command to the client' option.

enableAppMonitoringboolean | nullableOptional

Enable or disable the 'Application Monitoring' option.

useRemoteAppsboolean | nullableOptional

Enable or disable the 'Use RemoteApps if available' option.

allowFileTransferboolean | nullableOptionalDeprecated

Deprecated: use FileTransferMode instead. Enable or disable the 'Allow file transfer' option. (deprecated)

fileTransferModestring · enumOptional

File Transfer Control modes.

Possible values:
fileTransferLocationstring | nullableOptional

Location where the File Transfer takes place, if and where it is allowed.

fileTransferLockLocationboolean | nullableOptional

Lock Location where the File Transfer takes place, if and where it is allowed.

allowDragAndDropboolean | nullableOptionalDeprecated

Enable or disable the 'Allow local to remote drag and drop' option. (deprecated)

dragAndDropModestring · enumOptional

Drag and drop redirection values.

Possible values:
manageRDPTransportProtocolstring · enumOptional

Manage RDP transport protocol.

Possible values:
printerNameFormatstring · enumOptional

Printer Name Format

Possible values:
removeClientNameFromPrinterNameboolean | nullableOptional

Enable or disable the 'Remove client name from printer name' option.

removeSessionNumberFromPrinterNameboolean | nullableOptional

Enable or disable the 'Remove session number from printer name' option.

technologystring · enumOptional

User Profile Technology values.

Possible values:
updModestring · enumOptional

User Profile Disk Mode.

Possible values:
updRoamingModestring · enumOptional

User Profile Disk Roaming Mode.

Possible values:
upDiskPathstring | nullableOptional

Specifies the User Profile Disk path.

maxUserProfileDiskSizeGBinteger · int32 | nullableOptional

Specifies the max user profile disk size (in GB).

includeFolderPathstring[] | nullableOptional

Specifies the UPD 'Include' folder paths.

includeFilePathstring[] | nullableOptional

Specifies the UPD 'Include' file paths.

excludeFolderPathstring[] | nullableOptional

Specifies the UPD 'Exclude' folder paths.

excludeFilePathstring[] | nullableOptional

Specifies the UPD 'Exclude' file paths.

restrictDesktopAccessboolean | nullableOptional

Enable or disable the 'Restrict direct desktop access to the following users' option. Use the RestrictedUsers parameter to specify the list of users.

restrictedUsersstring[] | nullableOptional

Specifies the list of users for the RestrictDesktopAccess option (the option should be enabled). The list can contain user account names and user SIDs.

Responses
201

Created

application/json; api-version=1.0
post
POST /api/RDS/HostPool HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 1851

{
  "name": "text",
  "siteId": 1,
  "description": "text",
  "autoscale": true,
  "rasTemplateId": 1,
  "rasTemplateVersionId": 1,
  "minServersFromTemplate": 1,
  "maxServersFromTemplate": 1,
  "hostName": "text",
  "defaultPowerState": [
    "0 = PoweredOn",
    "1 = PoweredOff",
    "2 = Suspended"
  ],
  "hostsToCreate": 1,
  "workLoadThreshold": 1,
  "serversToAddPerRequest": 1,
  "workLoadToDrain": 1,
  "drainRemainsBelowSec": 1,
  "removeServersAfterDrainAndPowerOff": true,
  "rdsIds": [
    1
  ],
  "inheritDefaultAgentSettings": true,
  "inheritDefaultPrinterSettings": true,
  "inheritDefaultUserProfileSettings": true,
  "inheritDefaultDesktopAccessSettings": true,
  "inheritDefaultAutoUpgradeSettings": true,
  "port": 1,
  "maxSessions": 1,
  "disconnectActiveSessionAfter": 1,
  "logoffDisconnectedSessionAfter": 1,
  "allowURLAndMailRedirection": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = EnabledWithAppRegistration"
  ],
  "supportShellURLNamespaceObjects": true,
  "preferredBrokerId": 1,
  "allowRemoteExec": true,
  "enableAppMonitoring": true,
  "useRemoteApps": true,
  "fileTransferMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "fileTransferLocation": "text",
  "fileTransferLockLocation": true,
  "dragAndDropMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "manageRDPTransportProtocol": [
    "0 = Disabled",
    "1 = BothUDPTCP",
    "2 = OnlyTCP",
    "3 = EitherUDPTCP"
  ],
  "printerNameFormat": [
    "0 = PrnFormat_PRN_CMP_SES",
    "1 = PrnFormat_SES_CMP_PRN",
    "2 = PrnFormat_PRN_REDSES"
  ],
  "removeClientNameFromPrinterName": true,
  "removeSessionNumberFromPrinterName": true,
  "technology": [
    "0 = DoNotManage",
    "1 = UPD",
    "2 = FSLogix"
  ],
  "updMode": [
    "0 = DoNotChange",
    "1 = Enabled",
    "2 = Disabled"
  ],
  "updRoamingMode": [
    "0 = Exclude",
    "2 = Include"
  ],
  "upDiskPath": "text",
  "maxUserProfileDiskSizeGB": 1,
  "includeFolderPath": [
    "text"
  ],
  "includeFilePath": [
    "text"
  ],
  "excludeFolderPath": [
    "text"
  ],
  "excludeFilePath": [
    "text"
  ],
  "restrictDesktopAccess": true,
  "restrictedUsers": [
    "text"
  ]
}
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-08-29T23:41:17.335Z",
  "timeLastMod": "2025-08-29T23:41:17.335Z",
  "name": "text",
  "siteId": 1,
  "enabled": true,
  "description": "text",
  "autoscale": true,
  "rasTemplateId": 1,
  "rasTemplateVersionId": 1,
  "minServersFromTemplate": 1,
  "maxServersFromTemplate": 1,
  "workLoadThreshold": 1,
  "serversToAddPerRequest": 1,
  "workLoadToDrain": 1,
  "drainRemainsBelowSec": 1,
  "removeServersAfterDrainAndPowerOff": true,
  "inheritDefaultAgentSettings": true,
  "inheritDefaultPrinterSettings": true,
  "inheritDefaultUserProfileSettings": true,
  "inheritDefaultDesktopAccessSettings": true,
  "inheritDefaultAppPackageSettings": true,
  "inheritDefaultAutoUpgradeSettings": true,
  "rdsDefSettings": {
    "port": 1,
    "maxSessions": 1,
    "disconnectActiveSessionAfter": 1,
    "logoffDisconnectedSessionAfter": 1,
    "allowURLAndMailRedirection": [
      "0 = Disabled",
      "1 = Enabled",
      "2 = EnabledWithAppRegistration"
    ],
    "supportShellURLNamespaceObjects": true,
    "preferredBrokerId": 1,
    "enableDriveRedirectionCache": true,
    "allowRemoteExec": true,
    "enableAppMonitoring": true,
    "useRemoteApps": true,
    "allowFileTransfer": true,
    "fileTransferMode": [
      "0 = Disabled",
      "1 = ClientToServer",
      "2 = ServerToClient",
      "3 = Bidirectional"
    ],
    "fileTransferLocation": "text",
    "fileTransferLockLocation": true,
    "allowDragAndDrop": true,
    "dragAndDropMode": [
      "0 = Disabled",
      "1 = ClientToServer",
      "2 = ServerToClient",
      "3 = Bidirectional"
    ],
    "manageRDPTransportProtocol": [
      "0 = Disabled",
      "1 = BothUDPTCP",
      "2 = OnlyTCP",
      "3 = EitherUDPTCP"
    ],
    "printerNameFormat": [
      "0 = PrnFormat_PRN_CMP_SES",
      "1 = PrnFormat_SES_CMP_PRN",
      "2 = PrnFormat_PRN_REDSES"
    ],
    "removeClientNameFromPrinterName": true,
    "removeSessionNumberFromPrinterName": true,
    "technology": [
      "0 = DoNotManage",
      "1 = UPD",
      "2 = FSLogix"
    ],
    "fsLogix": {
      "profileContainer": {
        "enabled": true,
        "locationType": [
          "0 = SMBLocation",
          "1 = CloudCache"
        ],
        "vhdLocations": [
          "text"
        ],
        "ccdLocations": [
          "text"
        ],
        "profileDiskFormat": [
          "0 = VHD",
          "1 = VHDX"
        ],
        "allocationType": [
          "0 = Dynamic",
          "1 = Full"
        ],
        "defaultSize": 1,
        "userInclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "userExclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "cloudCache": {
          "useMaxCacheSizeInMBs": true,
          "maxCacheSizeInMBs": 1,
          "useClearCacheOnLogoff": true,
          "clearCacheOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useHealthyProvidersRequiredForRegister": true,
          "healthyProvidersRequiredForRegister": 1,
          "useHealthyProvidersRequiredForUnregister": true,
          "healthyProvidersRequiredForUnregister": 1,
          "useUnregisterTimeout": true,
          "unregisterTimeout": 1,
          "useClearCacheOnForcedUnregister": true,
          "clearCacheOnForcedUnregister": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "customizeProfileFolders": true,
        "excludeCommonFolders": [
          "1 = Contacts",
          "2 = Desktop",
          "4 = Documents",
          "8 = Links",
          "16 = MusicPodcasts",
          "32 = PicturesVideos",
          "64 = FoldersLowIntegProcesses",
          "128 = Downloads"
        ],
        "folderInclusionList": [
          "text"
        ],
        "folderExclusionList": [
          {
            "folder": "text",
            "excludeFolderCopy": [
              "0 = None",
              "1 = CopyBase",
              "2 = CopyBack"
            ]
          }
        ],
        "advancedSettings": {
          "useLockedRetryCount": true,
          "lockedRetryCount": 1,
          "useLockedRetryInterval": true,
          "lockedRetryInterval": 1,
          "useAccessNetworkAsComputerObject": true,
          "accessNetworkAsComputerObject": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useAttachVHDSDDL": true,
          "attachVHDSDDL": "text",
          "useDiffDiskParentFolderPath": true,
          "diffDiskParentFolderPath": "text",
          "useFlipFlopProfileDirectoryName": true,
          "flipFlopProfileDirectoryName": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useNoProfileContainingFolder": true,
          "noProfileContainingFolder": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useOutlookCachedMode": true,
          "outlookCachedMode": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithFailure": true,
          "preventLoginWithFailure": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithTempProfile": true,
          "preventLoginWithTempProfile": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useReAttachRetryCount": true,
          "reAttachRetryCount": 1,
          "useReAttachIntervalSeconds": true,
          "reAttachIntervalSeconds": 1,
          "useRemoveOrphanedOSTFilesOnLogoff": true,
          "removeOrphanedOSTFilesOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamSearch": true,
          "roamSearch": [
            "0 = Disable",
            "1 = SingleUser",
            "2 = MultiUser"
          ],
          "useSIDDirNameMatch": true,
          "sidDirNameMatch": "text",
          "useSIDDirNamePattern": true,
          "sidDirNamePattern": "text",
          "useSIDDirSDDL": true,
          "sidDirSDDL": "text",
          "useVHDNameMatch": true,
          "vhdNameMatch": "text",
          "useVHDNamePattern": true,
          "vhdNamePattern": "text",
          "useVHDXSectorSize": true,
          "vhdxSectorSize": [
            "0 = SystemDefault",
            "512 = Size_512",
            "4096 = Size_4096"
          ],
          "useVolumeWaitTimeMS": true,
          "volumeWaitTimeMS": 1,
          "useIgnoreNonAVD": true,
          "ignoreNonAVD": [
            "0 = AnySession",
            "1 = AVDSessions"
          ],
          "useRedirectType": true,
          "redirectType": [
            "1 = Legacy",
            "2 = Advanced"
          ],
          "useKeepLocalDir": true,
          "keepLocalDir": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useDeleteLocalProfileWhenVHDShouldApply": true,
          "deleteLocalProfileWhenVHDShouldApply": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useProfileDirSDDL": true,
          "profileDirSDDL": "text",
          "useProfileType": true,
          "profileType": [
            "0 = NormalProfile",
            "1 = OnlyRWProfile",
            "2 = OnlyROProfile",
            "3 = RWROProfile"
          ],
          "useSetTempToLocalPath": true,
          "setTempToLocalPath": [
            "0 = TakeNoAction",
            "1 = RedirectTempAndTmp",
            "2 = RedirectINetCache",
            "3 = RedirectTempTmpAndINetCache"
          ],
          "useCleanOutNotifications": true,
          "cleanOutNotifications": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useInstallAppxPackages": true,
          "installAppxPackages": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRebootOnUserLogoff": true,
          "rebootOnUserLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamIdentity": true,
          "roamIdentity": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useShutdownOnUserLogoff": true,
          "shutdownOnUserLogoff": [
            "0 = Disable",
            "1 = Enable"
          ]
        }
      },
      "officeContainer": {
        "enabled": true,
        "locationType": [
          "0 = SMBLocation",
          "1 = CloudCache"
        ],
        "vhdLocations": [
          "text"
        ],
        "ccdLocations": [
          "text"
        ],
        "profileDiskFormat": [
          "0 = VHD",
          "1 = VHDX"
        ],
        "allocationType": [
          "0 = Dynamic",
          "1 = Full"
        ],
        "defaultSize": 1,
        "userInclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "userExclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "cloudCache": {
          "useMaxCacheSizeInMBs": true,
          "maxCacheSizeInMBs": 1,
          "useClearCacheOnLogoff": true,
          "clearCacheOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useHealthyProvidersRequiredForRegister": true,
          "healthyProvidersRequiredForRegister": 1,
          "useHealthyProvidersRequiredForUnregister": true,
          "healthyProvidersRequiredForUnregister": 1,
          "useUnregisterTimeout": true,
          "unregisterTimeout": 1,
          "useClearCacheOnForcedUnregister": true,
          "clearCacheOnForcedUnregister": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "advancedSettings": {
          "useLockedRetryCount": true,
          "lockedRetryCount": 1,
          "useLockedRetryInterval": true,
          "lockedRetryInterval": 1,
          "useAccessNetworkAsComputerObject": true,
          "accessNetworkAsComputerObject": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useAttachVHDSDDL": true,
          "attachVHDSDDL": "text",
          "useDiffDiskParentFolderPath": true,
          "diffDiskParentFolderPath": "text",
          "useFlipFlopProfileDirectoryName": true,
          "flipFlopProfileDirectoryName": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useNoProfileContainingFolder": true,
          "noProfileContainingFolder": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useOutlookCachedMode": true,
          "outlookCachedMode": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithFailure": true,
          "preventLoginWithFailure": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithTempProfile": true,
          "preventLoginWithTempProfile": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useReAttachRetryCount": true,
          "reAttachRetryCount": 1,
          "useReAttachIntervalSeconds": true,
          "reAttachIntervalSeconds": 1,
          "useRemoveOrphanedOSTFilesOnLogoff": true,
          "removeOrphanedOSTFilesOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamSearch": true,
          "roamSearch": [
            "0 = Disable",
            "1 = SingleUser",
            "2 = MultiUser"
          ],
          "useSIDDirNameMatch": true,
          "sidDirNameMatch": "text",
          "useSIDDirNamePattern": true,
          "sidDirNamePattern": "text",
          "useSIDDirSDDL": true,
          "sidDirSDDL": "text",
          "useVHDNameMatch": true,
          "vhdNameMatch": "text",
          "useVHDNamePattern": true,
          "vhdNamePattern": "text",
          "useVHDXSectorSize": true,
          "vhdxSectorSize": [
            "0 = SystemDefault",
            "512 = Size_512",
            "4096 = Size_4096"
          ],
          "useVolumeWaitTimeMS": true,
          "volumeWaitTimeMS": 1,
          "useIgnoreNonAVD": true,
          "ignoreNonAVD": [
            "0 = AnySession",
            "1 = AVDSessions"
          ],
          "useRedirectType": true,
          "redirectType": [
            "1 = Legacy",
            "2 = Advanced"
          ],
          "useIncludeOfficeActivation": true,
          "includeOfficeActivation": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOneDrive": true,
          "includeOneDrive": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOneNote": true,
          "includeOneNote": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOneNoteUWP": true,
          "includeOneNoteUWP": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOutlook": true,
          "includeOutlook": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOutlookPersonalization": true,
          "includeOutlookPersonalization": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeSharepoint": true,
          "includeSharepoint": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeSkype": true,
          "includeSkype": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeTeams": true,
          "includeTeams": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useMirrorLocalOSTToVHD": true,
          "mirrorLocalOSTToVHD": [
            "0 = DoNothing",
            "1 = Copy",
            "2 = Move"
          ],
          "useNumSessionVHDsToKeep": true,
          "numSessionVHDsToKeep": 1,
          "useOutlookFolderPath": true,
          "outlookFolderPath": "text",
          "useRefreshUserPolicy": true,
          "refreshUserPolicy": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useVHDAccessMode": true,
          "vhdAccessMode": [
            "0 = NormalDirectAccess",
            "1 = DiffDiskNetwork",
            "2 = DiffDiskLocal",
            "3 = UniqueVHDPerSession"
          ]
        }
      },
      "generalSettings": {
        "appServices": {
          "useCleanupInvalidSessions": true,
          "cleanupInvalidSessions": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamRecycleBin": true,
          "roamRecycleBin": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useVHDCompactDisk": true,
          "vhdCompactDisk": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "cloudCacheGeneral": {
          "useCacheDirectory": true,
          "cacheDirectory": "text",
          "useWriteCacheDirectory": true,
          "writeCacheDirectory": "text",
          "useProxyDirectory": true,
          "proxyDirectory": "text",
          "useSilenceACLWarning": true,
          "silenceACLWarning": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "logging": {
          "logEnabled": [
            "0 = Disable",
            "1 = Specific",
            "2 = All"
          ],
          "logLevel": [
            "0 = Debug",
            "1 = Information",
            "2 = Warning",
            "3 = Error"
          ],
          "logFileKeepingPeriod": 1,
          "logDirectory": "text",
          "robocopyLogPath": "text",
          "logSpecificComponents": [
            "1 = ProfileConfigTool",
            "2 = IEPlugin",
            "4 = RuleEditor",
            "8 = JavaRuleEditor",
            "16 = FSLogixAgentService",
            "32 = Profile",
            "64 = JavaLauncher",
            "128 = OfficeContainer",
            "256 = RuleCompilation",
            "512 = FontVisibility",
            "1024 = Network",
            "2048 = PrinterVisibility",
            "4096 = ADSComputerGroup",
            "8192 = DriverInterface",
            "16384 = WindowsSearchRoaming",
            "32768 = WindowsSearchPlugin",
            "65536 = ProcessStartMonitor"
          ]
        }
      }
    },
    "updMode": [
      "0 = DoNotChange",
      "1 = Enabled",
      "2 = Disabled"
    ],
    "maxUserProfileDiskSizeGB": 1,
    "diskPath": "text",
    "roamingMode": [
      "0 = Exclude",
      "2 = Include"
    ],
    "includeFolderPath": [
      "text"
    ],
    "includeFilePath": [
      "text"
    ],
    "excludeFolderPath": [
      "text"
    ],
    "excludeFilePath": [
      "text"
    ],
    "restrictDesktopAccess": true,
    "restrictedUsers": [
      "text"
    ],
    "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"
        ]
      }
    },
    "appPackagesAssigned": {
      "applicationPackagesAssigned": [
        {
          "version": "text",
          "tagName": "text",
          "tagId": 1,
          "packageName": "text"
        }
      ]
    },
    "autoUpgrade": {
      "enabled": true,
      "startDateTime": "2025-08-29T23:41:17.335Z",
      "drainModeDurationInSecs": 1,
      "forceLogoffSessions": true,
      "repeat": [
        "0 = Never",
        "1 = EveryDay",
        "2 = EveryWeek",
        "3 = Every2Weeks",
        "4 = EveryMonth",
        "5 = EveryYear",
        "6 = SpecificDays"
      ],
      "specificDays": [
        "0 = Never",
        "1 = Sunday",
        "2 = Monday",
        "4 = Tuesday",
        "8 = Wednesday",
        "16 = Thursday",
        "32 = Friday",
        "64 = Saturday"
      ],
      "messages": [
        {
          "id": 1,
          "enabled": true,
          "messageTitle": "text",
          "message": "text",
          "sendMsgSecs": 1,
          "sendMsgWhen": [
            "0 = Before",
            "1 = After"
          ]
        }
      ]
    }
  },
  "rdsIds": [
    1
  ],
  "rdsProvisioningSettings": {
    "hostName": "text",
    "defaultPowerState": [
      "0 = PoweredOn",
      "1 = PoweredOff",
      "2 = Suspended"
    ]
  }
}

Get

get

Retrieve information about a RD Session Host Pool.

Path parameters
idinteger · int32Required

ID of the RD Session Host Pool to be retrieved

Responses
200

Success

application/json; api-version=1.0
get
GET /api/RDS/HostPool/{id} HTTP/1.1
Host: 
Accept: */*
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-08-29T23:41:17.335Z",
  "timeLastMod": "2025-08-29T23:41:17.335Z",
  "name": "text",
  "siteId": 1,
  "enabled": true,
  "description": "text",
  "autoscale": true,
  "rasTemplateId": 1,
  "rasTemplateVersionId": 1,
  "minServersFromTemplate": 1,
  "maxServersFromTemplate": 1,
  "workLoadThreshold": 1,
  "serversToAddPerRequest": 1,
  "workLoadToDrain": 1,
  "drainRemainsBelowSec": 1,
  "removeServersAfterDrainAndPowerOff": true,
  "inheritDefaultAgentSettings": true,
  "inheritDefaultPrinterSettings": true,
  "inheritDefaultUserProfileSettings": true,
  "inheritDefaultDesktopAccessSettings": true,
  "inheritDefaultAppPackageSettings": true,
  "inheritDefaultAutoUpgradeSettings": true,
  "rdsDefSettings": {
    "port": 1,
    "maxSessions": 1,
    "disconnectActiveSessionAfter": 1,
    "logoffDisconnectedSessionAfter": 1,
    "allowURLAndMailRedirection": [
      "0 = Disabled",
      "1 = Enabled",
      "2 = EnabledWithAppRegistration"
    ],
    "supportShellURLNamespaceObjects": true,
    "preferredBrokerId": 1,
    "enableDriveRedirectionCache": true,
    "allowRemoteExec": true,
    "enableAppMonitoring": true,
    "useRemoteApps": true,
    "allowFileTransfer": true,
    "fileTransferMode": [
      "0 = Disabled",
      "1 = ClientToServer",
      "2 = ServerToClient",
      "3 = Bidirectional"
    ],
    "fileTransferLocation": "text",
    "fileTransferLockLocation": true,
    "allowDragAndDrop": true,
    "dragAndDropMode": [
      "0 = Disabled",
      "1 = ClientToServer",
      "2 = ServerToClient",
      "3 = Bidirectional"
    ],
    "manageRDPTransportProtocol": [
      "0 = Disabled",
      "1 = BothUDPTCP",
      "2 = OnlyTCP",
      "3 = EitherUDPTCP"
    ],
    "printerNameFormat": [
      "0 = PrnFormat_PRN_CMP_SES",
      "1 = PrnFormat_SES_CMP_PRN",
      "2 = PrnFormat_PRN_REDSES"
    ],
    "removeClientNameFromPrinterName": true,
    "removeSessionNumberFromPrinterName": true,
    "technology": [
      "0 = DoNotManage",
      "1 = UPD",
      "2 = FSLogix"
    ],
    "fsLogix": {
      "profileContainer": {
        "enabled": true,
        "locationType": [
          "0 = SMBLocation",
          "1 = CloudCache"
        ],
        "vhdLocations": [
          "text"
        ],
        "ccdLocations": [
          "text"
        ],
        "profileDiskFormat": [
          "0 = VHD",
          "1 = VHDX"
        ],
        "allocationType": [
          "0 = Dynamic",
          "1 = Full"
        ],
        "defaultSize": 1,
        "userInclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "userExclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "cloudCache": {
          "useMaxCacheSizeInMBs": true,
          "maxCacheSizeInMBs": 1,
          "useClearCacheOnLogoff": true,
          "clearCacheOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useHealthyProvidersRequiredForRegister": true,
          "healthyProvidersRequiredForRegister": 1,
          "useHealthyProvidersRequiredForUnregister": true,
          "healthyProvidersRequiredForUnregister": 1,
          "useUnregisterTimeout": true,
          "unregisterTimeout": 1,
          "useClearCacheOnForcedUnregister": true,
          "clearCacheOnForcedUnregister": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "customizeProfileFolders": true,
        "excludeCommonFolders": [
          "1 = Contacts",
          "2 = Desktop",
          "4 = Documents",
          "8 = Links",
          "16 = MusicPodcasts",
          "32 = PicturesVideos",
          "64 = FoldersLowIntegProcesses",
          "128 = Downloads"
        ],
        "folderInclusionList": [
          "text"
        ],
        "folderExclusionList": [
          {
            "folder": "text",
            "excludeFolderCopy": [
              "0 = None",
              "1 = CopyBase",
              "2 = CopyBack"
            ]
          }
        ],
        "advancedSettings": {
          "useLockedRetryCount": true,
          "lockedRetryCount": 1,
          "useLockedRetryInterval": true,
          "lockedRetryInterval": 1,
          "useAccessNetworkAsComputerObject": true,
          "accessNetworkAsComputerObject": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useAttachVHDSDDL": true,
          "attachVHDSDDL": "text",
          "useDiffDiskParentFolderPath": true,
          "diffDiskParentFolderPath": "text",
          "useFlipFlopProfileDirectoryName": true,
          "flipFlopProfileDirectoryName": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useNoProfileContainingFolder": true,
          "noProfileContainingFolder": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useOutlookCachedMode": true,
          "outlookCachedMode": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithFailure": true,
          "preventLoginWithFailure": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithTempProfile": true,
          "preventLoginWithTempProfile": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useReAttachRetryCount": true,
          "reAttachRetryCount": 1,
          "useReAttachIntervalSeconds": true,
          "reAttachIntervalSeconds": 1,
          "useRemoveOrphanedOSTFilesOnLogoff": true,
          "removeOrphanedOSTFilesOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamSearch": true,
          "roamSearch": [
            "0 = Disable",
            "1 = SingleUser",
            "2 = MultiUser"
          ],
          "useSIDDirNameMatch": true,
          "sidDirNameMatch": "text",
          "useSIDDirNamePattern": true,
          "sidDirNamePattern": "text",
          "useSIDDirSDDL": true,
          "sidDirSDDL": "text",
          "useVHDNameMatch": true,
          "vhdNameMatch": "text",
          "useVHDNamePattern": true,
          "vhdNamePattern": "text",
          "useVHDXSectorSize": true,
          "vhdxSectorSize": [
            "0 = SystemDefault",
            "512 = Size_512",
            "4096 = Size_4096"
          ],
          "useVolumeWaitTimeMS": true,
          "volumeWaitTimeMS": 1,
          "useIgnoreNonAVD": true,
          "ignoreNonAVD": [
            "0 = AnySession",
            "1 = AVDSessions"
          ],
          "useRedirectType": true,
          "redirectType": [
            "1 = Legacy",
            "2 = Advanced"
          ],
          "useKeepLocalDir": true,
          "keepLocalDir": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useDeleteLocalProfileWhenVHDShouldApply": true,
          "deleteLocalProfileWhenVHDShouldApply": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useProfileDirSDDL": true,
          "profileDirSDDL": "text",
          "useProfileType": true,
          "profileType": [
            "0 = NormalProfile",
            "1 = OnlyRWProfile",
            "2 = OnlyROProfile",
            "3 = RWROProfile"
          ],
          "useSetTempToLocalPath": true,
          "setTempToLocalPath": [
            "0 = TakeNoAction",
            "1 = RedirectTempAndTmp",
            "2 = RedirectINetCache",
            "3 = RedirectTempTmpAndINetCache"
          ],
          "useCleanOutNotifications": true,
          "cleanOutNotifications": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useInstallAppxPackages": true,
          "installAppxPackages": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRebootOnUserLogoff": true,
          "rebootOnUserLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamIdentity": true,
          "roamIdentity": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useShutdownOnUserLogoff": true,
          "shutdownOnUserLogoff": [
            "0 = Disable",
            "1 = Enable"
          ]
        }
      },
      "officeContainer": {
        "enabled": true,
        "locationType": [
          "0 = SMBLocation",
          "1 = CloudCache"
        ],
        "vhdLocations": [
          "text"
        ],
        "ccdLocations": [
          "text"
        ],
        "profileDiskFormat": [
          "0 = VHD",
          "1 = VHDX"
        ],
        "allocationType": [
          "0 = Dynamic",
          "1 = Full"
        ],
        "defaultSize": 1,
        "userInclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "userExclusionList": [
          {
            "account": "text",
            "type": [
              "1 = User",
              "2 = Group",
              "3 = ForeignSecurityPrincipal",
              "4 = Computer"
            ],
            "sid": "text"
          }
        ],
        "cloudCache": {
          "useMaxCacheSizeInMBs": true,
          "maxCacheSizeInMBs": 1,
          "useClearCacheOnLogoff": true,
          "clearCacheOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useHealthyProvidersRequiredForRegister": true,
          "healthyProvidersRequiredForRegister": 1,
          "useHealthyProvidersRequiredForUnregister": true,
          "healthyProvidersRequiredForUnregister": 1,
          "useUnregisterTimeout": true,
          "unregisterTimeout": 1,
          "useClearCacheOnForcedUnregister": true,
          "clearCacheOnForcedUnregister": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "advancedSettings": {
          "useLockedRetryCount": true,
          "lockedRetryCount": 1,
          "useLockedRetryInterval": true,
          "lockedRetryInterval": 1,
          "useAccessNetworkAsComputerObject": true,
          "accessNetworkAsComputerObject": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useAttachVHDSDDL": true,
          "attachVHDSDDL": "text",
          "useDiffDiskParentFolderPath": true,
          "diffDiskParentFolderPath": "text",
          "useFlipFlopProfileDirectoryName": true,
          "flipFlopProfileDirectoryName": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useNoProfileContainingFolder": true,
          "noProfileContainingFolder": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useOutlookCachedMode": true,
          "outlookCachedMode": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithFailure": true,
          "preventLoginWithFailure": [
            "0 = Disable",
            "1 = Enable"
          ],
          "usePreventLoginWithTempProfile": true,
          "preventLoginWithTempProfile": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useReAttachRetryCount": true,
          "reAttachRetryCount": 1,
          "useReAttachIntervalSeconds": true,
          "reAttachIntervalSeconds": 1,
          "useRemoveOrphanedOSTFilesOnLogoff": true,
          "removeOrphanedOSTFilesOnLogoff": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamSearch": true,
          "roamSearch": [
            "0 = Disable",
            "1 = SingleUser",
            "2 = MultiUser"
          ],
          "useSIDDirNameMatch": true,
          "sidDirNameMatch": "text",
          "useSIDDirNamePattern": true,
          "sidDirNamePattern": "text",
          "useSIDDirSDDL": true,
          "sidDirSDDL": "text",
          "useVHDNameMatch": true,
          "vhdNameMatch": "text",
          "useVHDNamePattern": true,
          "vhdNamePattern": "text",
          "useVHDXSectorSize": true,
          "vhdxSectorSize": [
            "0 = SystemDefault",
            "512 = Size_512",
            "4096 = Size_4096"
          ],
          "useVolumeWaitTimeMS": true,
          "volumeWaitTimeMS": 1,
          "useIgnoreNonAVD": true,
          "ignoreNonAVD": [
            "0 = AnySession",
            "1 = AVDSessions"
          ],
          "useRedirectType": true,
          "redirectType": [
            "1 = Legacy",
            "2 = Advanced"
          ],
          "useIncludeOfficeActivation": true,
          "includeOfficeActivation": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOneDrive": true,
          "includeOneDrive": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOneNote": true,
          "includeOneNote": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOneNoteUWP": true,
          "includeOneNoteUWP": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOutlook": true,
          "includeOutlook": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeOutlookPersonalization": true,
          "includeOutlookPersonalization": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeSharepoint": true,
          "includeSharepoint": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeSkype": true,
          "includeSkype": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useIncludeTeams": true,
          "includeTeams": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useMirrorLocalOSTToVHD": true,
          "mirrorLocalOSTToVHD": [
            "0 = DoNothing",
            "1 = Copy",
            "2 = Move"
          ],
          "useNumSessionVHDsToKeep": true,
          "numSessionVHDsToKeep": 1,
          "useOutlookFolderPath": true,
          "outlookFolderPath": "text",
          "useRefreshUserPolicy": true,
          "refreshUserPolicy": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useVHDAccessMode": true,
          "vhdAccessMode": [
            "0 = NormalDirectAccess",
            "1 = DiffDiskNetwork",
            "2 = DiffDiskLocal",
            "3 = UniqueVHDPerSession"
          ]
        }
      },
      "generalSettings": {
        "appServices": {
          "useCleanupInvalidSessions": true,
          "cleanupInvalidSessions": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useRoamRecycleBin": true,
          "roamRecycleBin": [
            "0 = Disable",
            "1 = Enable"
          ],
          "useVHDCompactDisk": true,
          "vhdCompactDisk": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "cloudCacheGeneral": {
          "useCacheDirectory": true,
          "cacheDirectory": "text",
          "useWriteCacheDirectory": true,
          "writeCacheDirectory": "text",
          "useProxyDirectory": true,
          "proxyDirectory": "text",
          "useSilenceACLWarning": true,
          "silenceACLWarning": [
            "0 = Disable",
            "1 = Enable"
          ]
        },
        "logging": {
          "logEnabled": [
            "0 = Disable",
            "1 = Specific",
            "2 = All"
          ],
          "logLevel": [
            "0 = Debug",
            "1 = Information",
            "2 = Warning",
            "3 = Error"
          ],
          "logFileKeepingPeriod": 1,
          "logDirectory": "text",
          "robocopyLogPath": "text",
          "logSpecificComponents": [
            "1 = ProfileConfigTool",
            "2 = IEPlugin",
            "4 = RuleEditor",
            "8 = JavaRuleEditor",
            "16 = FSLogixAgentService",
            "32 = Profile",
            "64 = JavaLauncher",
            "128 = OfficeContainer",
            "256 = RuleCompilation",
            "512 = FontVisibility",
            "1024 = Network",
            "2048 = PrinterVisibility",
            "4096 = ADSComputerGroup",
            "8192 = DriverInterface",
            "16384 = WindowsSearchRoaming",
            "32768 = WindowsSearchPlugin",
            "65536 = ProcessStartMonitor"
          ]
        }
      }
    },
    "updMode": [
      "0 = DoNotChange",
      "1 = Enabled",
      "2 = Disabled"
    ],
    "maxUserProfileDiskSizeGB": 1,
    "diskPath": "text",
    "roamingMode": [
      "0 = Exclude",
      "2 = Include"
    ],
    "includeFolderPath": [
      "text"
    ],
    "includeFilePath": [
      "text"
    ],
    "excludeFolderPath": [
      "text"
    ],
    "excludeFilePath": [
      "text"
    ],
    "restrictDesktopAccess": true,
    "restrictedUsers": [
      "text"
    ],
    "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"
        ]
      }
    },
    "appPackagesAssigned": {
      "applicationPackagesAssigned": [
        {
          "version": "text",
          "tagName": "text",
          "tagId": 1,
          "packageName": "text"
        }
      ]
    },
    "autoUpgrade": {
      "enabled": true,
      "startDateTime": "2025-08-29T23:41:17.335Z",
      "drainModeDurationInSecs": 1,
      "forceLogoffSessions": true,
      "repeat": [
        "0 = Never",
        "1 = EveryDay",
        "2 = EveryWeek",
        "3 = Every2Weeks",
        "4 = EveryMonth",
        "5 = EveryYear",
        "6 = SpecificDays"
      ],
      "specificDays": [
        "0 = Never",
        "1 = Sunday",
        "2 = Monday",
        "4 = Tuesday",
        "8 = Wednesday",
        "16 = Thursday",
        "32 = Friday",
        "64 = Saturday"
      ],
      "messages": [
        {
          "id": 1,
          "enabled": true,
          "messageTitle": "text",
          "message": "text",
          "sendMsgSecs": 1,
          "sendMsgWhen": [
            "0 = Before",
            "1 = After"
          ]
        }
      ]
    }
  },
  "rdsIds": [
    1
  ],
  "rdsProvisioningSettings": {
    "hostName": "text",
    "defaultPowerState": [
      "0 = PoweredOn",
      "1 = PoweredOff",
      "2 = Suspended"
    ]
  }
}

Update

put

Modify the properties of a RD Session Host Pool

Path parameters
idinteger · int32Required

ID of the RD Session Host Pool to be updated

Body

Update RD Session Host Pool settings

enabledboolean | nullableOptional

Enable or disable the specified host pool(s) in a site.

namestring | nullableOptional

A new name to assign to the specified host pool.

descriptionstring | nullableOptional

A description of the specified host pool.

autoscaleboolean | nullableOptional

Enable or disable Autoscaling.

rasTemplateIdinteger · int32 | nullableOptional

The RDSH RAS Template ID.

rasTemplateVersionIdinteger · int32 | nullableOptional

The RDSH RAS Template Version ID.

minServersFromTemplateinteger · int32 | nullableOptional

Min number of servers to be added to the host pool from the RAS Template.

maxServersFromTemplateinteger · int32 | nullableOptional

Max number of servers to be added to the host pool from the RAS Template.

hostNamestring | nullableOptional

The VM name format. All VMs created from the template will have this name with %ID:N:S% replaced.

defaultPowerStatestring · enumOptional

Session Type

Possible values:
workLoadThresholdinteger · int32 | nullableOptional

Send a request to the RAS template when the workload threshold is above the specified value.

serversToAddPerRequestinteger · int32 | nullableOptional

Number of servers to be added to the host pool per request.

workLoadToDraininteger · int32 | nullableOptional

Drain and unassign servers from host pool when workload is below the specified value.

drainRemainsBelowSecinteger · int32 | nullableOptional

Drain and unassign servers from host pool when workload remains below the specified level for the below specified time (in seconds).

removeServersAfterDrainAndPowerOffboolean | nullableOptional

Remove servers from host pool after drain and power off.

inheritDefaultAgentSettingsboolean | nullableOptional

Enable or disable the 'Inherit default agent settings' option. This will inherit Global agent settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultPrinterSettingsboolean | nullableOptional

Enable or disable the 'Inherit default printer settings' option. This will inherit Global printer settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultUserProfileSettingsboolean | nullableOptional

Enable or disable the 'Inherit default user profile settings' option. This will inherit Global User Profile settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultDesktopAccessSettingsboolean | nullableOptional

Enable or disable the 'Inherit default desktop access settings' option. This will inherit Global Desktop Access settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

inheritDefaultAutoUpgradeSettingsboolean | nullableOptional

Enable or disable the 'Inherit Auto-upgrade settings' option. This will inherit Global Auto-upgrade settings from the default profile. If you would like to specify custom settings, you need to disable this option and specify the desired parameters.

portinteger · int32 | nullableOptional

Specifies the port number for the RD Session Host agent.

maxSessionsinteger · int32 | nullableOptional

Specifies the 'Maximum Sessions' property.

disconnectActiveSessionAfterinteger · int32 | nullableOptional

Disconnect active session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'.

logoffDisconnectedSessionAfterinteger · int32 | nullableOptional

Logoff disconnected session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'; 1 for 'Immediate'.

allowURLAndMailRedirectionstring · enumOptional

URL and Mail Redirection values.

Possible values:
supportShellURLNamespaceObjectsboolean | nullableOptional

Enable or disable the 'Support Shell URL Namespace Objects' option.

autoPreferredBrokerbooleanOptional

Set the 'Preferred Connection Broker' option to 'Automatically".

Default: false
preferredBrokerIdinteger · int32 | nullableOptional

The preferred Connection Broker.

enableDriveRedirectionCacheboolean | nullableOptional

Enable or disable the 'Enable Drive Redirection Cache' option.

allowRemoteExecboolean | nullableOptional

Enable or disable the 'Allow 2XRemoteExec to send command to the client' option.

enableAppMonitoringboolean | nullableOptional

Enable or disable the 'Application Monitoring' option.

useRemoteAppsboolean | nullableOptional

Enable or disable the 'Use RemoteApps if available' option.

allowFileTransferboolean | nullableOptionalDeprecated

Deprecated: use FileTransferMode instead. Enable or disable the 'Allow file transfer' option.

fileTransferModestring · enumOptional

File Transfer Control modes.

Possible values:
fileTransferLocationstring | nullableOptional

Location where the File Transfer takes place, if and where it is allowed.

fileTransferLockLocationboolean | nullableOptional

Lock Location where the File Transfer takes place, if and where it is allowed.

allowDragAndDropboolean | nullableOptionalDeprecated

Enable or disable the 'Allow local to remote drag and drop' option. (deprecated)

dragAndDropModestring · enumOptional

Drag and drop redirection values.

Possible values:
manageRDPTransportProtocolstring · enumOptional

Manage RDP transport protocol.

Possible values:
printerNameFormatstring · enumOptional

Printer Name Format

Possible values:
removeClientNameFromPrinterNameboolean | nullableOptional

Enable or disable the 'Remove client name from printer name' option.

removeSessionNumberFromPrinterNameboolean | nullableOptional

Enable or disable the 'Remove session number from printer name' option.

technologystring · enumOptional

User Profile Technology values.

Possible values:
updModestring · enumOptional

User Profile Disk Mode.

Possible values:
updRoamingModestring · enumOptional

User Profile Disk Roaming Mode.

Possible values:
upDiskPathstring | nullableOptional

Specifies the User Profile Disk path.

maxUserProfileDiskSizeGBinteger · int32 | nullableOptional

Specifies the max user profile disk size (in GB).

includeFolderPathstring[] | nullableOptional

Specifies the UPD 'Include' folder paths.

includeFilePathstring[] | nullableOptional

Specifies the UPD 'Include' file paths.

excludeFolderPathstring[] | nullableOptional

Specifies the UPD 'Exclude' folder paths.

excludeFilePathstring[] | nullableOptional

Specifies the UPD 'Exclude' file paths.

restrictDesktopAccessboolean | nullableOptional

Enable or disable the 'Restrict direct desktop access to the following users' option. Use the RestrictedUsers parameter to specify the list of users.

restrictedUsersstring[] | nullableOptional

Specifies the list of users for the RestrictDesktopAccess option (the option should be enabled). The list can contain user account names and user SIDs.

Responses
204

No Content

No content

put
PUT /api/RDS/HostPool/{id} HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 1887

{
  "enabled": true,
  "name": "text",
  "description": "text",
  "autoscale": true,
  "rasTemplateId": 1,
  "rasTemplateVersionId": 1,
  "minServersFromTemplate": 1,
  "maxServersFromTemplate": 1,
  "hostName": "text",
  "defaultPowerState": [
    "0 = PoweredOn",
    "1 = PoweredOff",
    "2 = Suspended"
  ],
  "workLoadThreshold": 1,
  "serversToAddPerRequest": 1,
  "workLoadToDrain": 1,
  "drainRemainsBelowSec": 1,
  "removeServersAfterDrainAndPowerOff": true,
  "inheritDefaultAgentSettings": true,
  "inheritDefaultPrinterSettings": true,
  "inheritDefaultUserProfileSettings": true,
  "inheritDefaultDesktopAccessSettings": true,
  "inheritDefaultAutoUpgradeSettings": true,
  "port": 1,
  "maxSessions": 1,
  "disconnectActiveSessionAfter": 1,
  "logoffDisconnectedSessionAfter": 1,
  "allowURLAndMailRedirection": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = EnabledWithAppRegistration"
  ],
  "supportShellURLNamespaceObjects": true,
  "autoPreferredBroker": false,
  "preferredBrokerId": 1,
  "enableDriveRedirectionCache": true,
  "allowRemoteExec": true,
  "enableAppMonitoring": true,
  "useRemoteApps": true,
  "fileTransferMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "fileTransferLocation": "text",
  "fileTransferLockLocation": true,
  "dragAndDropMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "manageRDPTransportProtocol": [
    "0 = Disabled",
    "1 = BothUDPTCP",
    "2 = OnlyTCP",
    "3 = EitherUDPTCP"
  ],
  "printerNameFormat": [
    "0 = PrnFormat_PRN_CMP_SES",
    "1 = PrnFormat_SES_CMP_PRN",
    "2 = PrnFormat_PRN_REDSES"
  ],
  "removeClientNameFromPrinterName": true,
  "removeSessionNumberFromPrinterName": true,
  "technology": [
    "0 = DoNotManage",
    "1 = UPD",
    "2 = FSLogix"
  ],
  "updMode": [
    "0 = DoNotChange",
    "1 = Enabled",
    "2 = Disabled"
  ],
  "updRoamingMode": [
    "0 = Exclude",
    "2 = Include"
  ],
  "upDiskPath": "text",
  "maxUserProfileDiskSizeGB": 1,
  "includeFolderPath": [
    "text"
  ],
  "includeFilePath": [
    "text"
  ],
  "excludeFolderPath": [
    "text"
  ],
  "excludeFilePath": [
    "text"
  ],
  "restrictDesktopAccess": true,
  "restrictedUsers": [
    "text"
  ]
}

No content

Delete

delete

Delete a RD Session Host Pool

Path parameters
idinteger · int32Required

ID of the RD Session Host Pool to be deleted

Responses
204

No Content

No content

delete
DELETE /api/RDS/HostPool/{id} HTTP/1.1
Host: 
Accept: */*

No content

Last updated

Was this helpful?