RDS

List

get

Retrieve a list of all the published RD Session Host applications

Query parameters

SiteIdinteger · int32Optional

Site ID for which to retrieve all the published RD Session Host applications (optional)

NamestringOptional

Filter the result by name (optional)

Responses

200

Success

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

HTTPcURLJavaScriptPython

GET /api/PubItems/Apps/RDS HTTP/1.1
Host: 
Accept: */*

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-06-05T08:26:16.747Z",
  "timeLastMod": "2025-06-05T08:26:16.747Z",
  "maintenanceMessages": {
    "maintenanceMessage_en_US": "text",
    "maintenanceMessage_ja_JP": "text",
    "maintenanceMessage_fr_FR": "text",
    "maintenanceMessage_es_ES": "text",
    "maintenanceMessage_it_IT": "text",
    "maintenanceMessage_pt_BR": "text",
    "maintenanceMessage_nl_NL": "text",
    "maintenanceMessage_zh_TW": "text",
    "maintenanceMessage_zh_CN": "text",
    "maintenanceMessage_ko_KR": "text",
    "maintenanceMessage_de_DE": "text"
  },
  "inheritMaintenance": true,
  "replicateMaintenance": true,
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop"
  ],
  "parentId": 1,
  "previousId": 1,
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": true,
  "publishToSite": [
    1
  ],
  "userFilterEnabled": true,
  "allowedUsers": [
    {
      "account": "text",
      "type": [
        "1 = User",
        "2 = Group",
        "3 = ForeignSecurityPrincipal",
        "4 = Computer"
      ],
      "sid": "text"
    }
  ],
  "clientFilterEnabled": true,
  "allowedClients": [
    "text"
  ],
  "ipFilterEnabled": true,
  "allowedIP4s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "allowedIP6s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "macFilterEnabled": true,
  "allowedMACs": [
    "text"
  ],
  "allowedGateways": [
    "text"
  ],
  "osFilterEnabled": true,
  "allowedOSes": {
    "chrome": true,
    "android": true,
    "webClient": true,
    "iOS": true,
    "linux": true,
    "mac": true,
    "wyse": true,
    "windows": true
  },
  "preferredRoutingEnabled": true,
  "preferredRoutes": [
    {
      "id": 1,
      "priority": 1,
      "name": "text",
      "description": "text",
      "enabled": true,
      "referenceType": [
        "3 = Gateway",
        "51 = HALB",
        "83 = Custom"
      ],
      "referenceId": 1
    }
  ],
  "filter": {
    "rules": [
      {
        "id": 1,
        "priority": 1,
        "enabled": true,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": true,
              "android": true,
              "webClient": true,
              "iOS": true,
              "linux": true,
              "mac": true,
              "wyse": true,
              "windows": true
            }
          },
          "iPs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": [
              1
            ]
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": true,
  "excludePrelaunch": true,
  "inheritShortcutDefaultSettings": true,
  "createShortcutOnDesktop": true,
  "createShortcutInStartFolder": true,
  "startPath": "text",
  "createShortcutInStartUpFolder": true,
  "replicateShortcutSettings": true,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "publishFromServer": [
    1
  ],
  "publishFromHostPool": [
    1
  ],
  "perServerAttributes": [
    {
      "parameters": "text",
      "startIn": "text",
      "target": "text",
      "serverId": 1,
      "package": "text",
      "packagedApp": "text"
    }
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "enableFileExtensions": true,
  "inheritDisplayDefaultSettings": true,
  "replicateDisplaySettings": true,
  "startMaximized": true,
  "startFullscreen": true,
  "waitForPrinters": true,
  "waitForPrintersTimeout": 1,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritLicenseDefaultSettings": true,
  "replicateLicenseSettings": true,
  "replicateFileExtensionSettings": true,
  "replicateDefaultServerSettings": true,
  "disableSessionSharing": true,
  "oneInstancePerUser": true,
  "conCurrentLicenses": 1,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "fileExtensions": [
    {
      "extension": "text",
      "parameters": "text",
      "enabled": true
    }
  ]
}

Create

post

Add a published RD Session Host application to a site.

Body

Create a new published application from a RD Session Host

namestring | nullableRequired

Published resource name.

parentIdinteger · int32 | nullableOptional

Parent publishing folder ID.

previousIdinteger · int32 | nullableOptional

Previous published ID.

replicateMaintenanceboolean | nullableOptional

Whether the option 'Replicate Maintenance' is enabled or not.

inheritMaintenanceboolean | nullableOptional

Whether to inherit default Maintenance settings.

enabledboolean | nullableOptionalDeprecated

Enable or disable a published resource.

enabledModestring · enumOptional

Published resource availability modes.

Possible values:

maintenanceMessage_en_USstring | nullableOptional

Maintenance message for the published resource in English.

maintenanceMessage_ja_JPstring | nullableOptional

Maintenance message for the published resource in Japanese.

maintenanceMessage_fr_FRstring | nullableOptional

Maintenance message for the published resource in French.

maintenanceMessage_es_ESstring | nullableOptional

Maintenance message for the published resource in Spanish.

maintenanceMessage_it_ITstring | nullableOptional

Maintenance message for the published resource in Italian.

maintenanceMessage_pt_BRstring | nullableOptional

Maintenance message for the published resource in Portuguese.

maintenanceMessage_de_DEstring | nullableOptional

Maintenance message for the published resource in German.

maintenanceMessage_nl_NLstring | nullableOptional

Maintenance message for the published resource in Dutch.

maintenanceMessage_zh_TWstring | nullableOptional

Maintenance message for the published resource in Chinese (Traditional).

maintenanceMessage_zh_CNstring | nullableOptional

Maintenance message for the published resource in Chinese (Simplified).

maintenanceMessage_ko_KRstring | nullableOptional

Maintenance message for the published resource in Korean.

descriptionstring | nullableOptional

Published resource description.

publishToSiteIdsinteger · int32[] | nullableOptional

An array of Sites IDs to which to publish a resource.

siteIdinteger · int32Optional

Site ID in which to publish the specified Item. If the parameter is omitted, the site ID of the Licensing Server will be used.

ipFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable IP filters.

clientFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable client filters.

macFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable mac filters.

userFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable user filters.

gatewayFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable Secure Gateway filters.

targetstring | nullableOptional

File name and path of a published application executable.

startInstring | nullableOptional

Folder name in which to start a published application.

parametersstring | nullableOptional

Optional parameters to pass to the published application executable.

packagestring | nullableOptional

The MSIX package.

packagedAppstring | nullableOptional

The Application within the MSIX Package.

startOnLogonbooleanOptional

Enable or disable the 'Start automatically when user logs on' option.

Default: false

winTypestring · enumOptional

Published application window type

Possible values:

publishFromstring · enumOptional

Publish From' options for published items.

Possible values:

publishFromHostPoolIdsinteger · int32[] | nullableOptional

Specifies one or multiple host pool Ids from which to publish the application. The PublishFrom parameter must specify 1 (HostPool).

publishFromServerIdsinteger · int32[] | nullableOptional

Specifies one or multiple RDS Host server Ids from which to publish a desktop. The PublishFrom parameter must specify 2 (Host).

Responses

201

Created

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

409

Conflict

application/json; api-version=1.0

post

HTTPcURLJavaScriptPython

POST /api/PubItems/Apps/RDS HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 866

{
  "name": "text",
  "parentId": 1,
  "previousId": 1,
  "replicateMaintenance": true,
  "inheritMaintenance": true,
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "maintenanceMessage_en_US": "text",
  "maintenanceMessage_ja_JP": "text",
  "maintenanceMessage_fr_FR": "text",
  "maintenanceMessage_es_ES": "text",
  "maintenanceMessage_it_IT": "text",
  "maintenanceMessage_pt_BR": "text",
  "maintenanceMessage_de_DE": "text",
  "maintenanceMessage_nl_NL": "text",
  "maintenanceMessage_zh_TW": "text",
  "maintenanceMessage_zh_CN": "text",
  "maintenanceMessage_ko_KR": "text",
  "description": "text",
  "publishToSiteIds": [
    1
  ],
  "siteId": 1,
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "startOnLogon": false,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "publishFromHostPoolIds": [
    1
  ],
  "publishFromServerIds": [
    1
  ]
}

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-06-05T08:26:16.747Z",
  "timeLastMod": "2025-06-05T08:26:16.747Z",
  "maintenanceMessages": {
    "maintenanceMessage_en_US": "text",
    "maintenanceMessage_ja_JP": "text",
    "maintenanceMessage_fr_FR": "text",
    "maintenanceMessage_es_ES": "text",
    "maintenanceMessage_it_IT": "text",
    "maintenanceMessage_pt_BR": "text",
    "maintenanceMessage_nl_NL": "text",
    "maintenanceMessage_zh_TW": "text",
    "maintenanceMessage_zh_CN": "text",
    "maintenanceMessage_ko_KR": "text",
    "maintenanceMessage_de_DE": "text"
  },
  "inheritMaintenance": true,
  "replicateMaintenance": true,
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop"
  ],
  "parentId": 1,
  "previousId": 1,
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": true,
  "publishToSite": [
    1
  ],
  "userFilterEnabled": true,
  "allowedUsers": [
    {
      "account": "text",
      "type": [
        "1 = User",
        "2 = Group",
        "3 = ForeignSecurityPrincipal",
        "4 = Computer"
      ],
      "sid": "text"
    }
  ],
  "clientFilterEnabled": true,
  "allowedClients": [
    "text"
  ],
  "ipFilterEnabled": true,
  "allowedIP4s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "allowedIP6s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "macFilterEnabled": true,
  "allowedMACs": [
    "text"
  ],
  "allowedGateways": [
    "text"
  ],
  "osFilterEnabled": true,
  "allowedOSes": {
    "chrome": true,
    "android": true,
    "webClient": true,
    "iOS": true,
    "linux": true,
    "mac": true,
    "wyse": true,
    "windows": true
  },
  "preferredRoutingEnabled": true,
  "preferredRoutes": [
    {
      "id": 1,
      "priority": 1,
      "name": "text",
      "description": "text",
      "enabled": true,
      "referenceType": [
        "3 = Gateway",
        "51 = HALB",
        "83 = Custom"
      ],
      "referenceId": 1
    }
  ],
  "filter": {
    "rules": [
      {
        "id": 1,
        "priority": 1,
        "enabled": true,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": true,
              "android": true,
              "webClient": true,
              "iOS": true,
              "linux": true,
              "mac": true,
              "wyse": true,
              "windows": true
            }
          },
          "iPs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": [
              1
            ]
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": true,
  "excludePrelaunch": true,
  "inheritShortcutDefaultSettings": true,
  "createShortcutOnDesktop": true,
  "createShortcutInStartFolder": true,
  "startPath": "text",
  "createShortcutInStartUpFolder": true,
  "replicateShortcutSettings": true,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "publishFromServer": [
    1
  ],
  "publishFromHostPool": [
    1
  ],
  "perServerAttributes": [
    {
      "parameters": "text",
      "startIn": "text",
      "target": "text",
      "serverId": 1,
      "package": "text",
      "packagedApp": "text"
    }
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "enableFileExtensions": true,
  "inheritDisplayDefaultSettings": true,
  "replicateDisplaySettings": true,
  "startMaximized": true,
  "startFullscreen": true,
  "waitForPrinters": true,
  "waitForPrintersTimeout": 1,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritLicenseDefaultSettings": true,
  "replicateLicenseSettings": true,
  "replicateFileExtensionSettings": true,
  "replicateDefaultServerSettings": true,
  "disableSessionSharing": true,
  "oneInstancePerUser": true,
  "conCurrentLicenses": 1,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "fileExtensions": [
    {
      "extension": "text",
      "parameters": "text",
      "enabled": true
    }
  ]
}

Get

get

Retrieve a specified published RD Session Host application

Path parameters

idinteger · int32Required

ID of the published RD Session Host application to be retrieved

Responses

200

Success

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

HTTPcURLJavaScriptPython

GET /api/PubItems/{id}/Apps/RDS HTTP/1.1
Host: 
Accept: */*

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-06-05T08:26:16.747Z",
  "timeLastMod": "2025-06-05T08:26:16.747Z",
  "maintenanceMessages": {
    "maintenanceMessage_en_US": "text",
    "maintenanceMessage_ja_JP": "text",
    "maintenanceMessage_fr_FR": "text",
    "maintenanceMessage_es_ES": "text",
    "maintenanceMessage_it_IT": "text",
    "maintenanceMessage_pt_BR": "text",
    "maintenanceMessage_nl_NL": "text",
    "maintenanceMessage_zh_TW": "text",
    "maintenanceMessage_zh_CN": "text",
    "maintenanceMessage_ko_KR": "text",
    "maintenanceMessage_de_DE": "text"
  },
  "inheritMaintenance": true,
  "replicateMaintenance": true,
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop"
  ],
  "parentId": 1,
  "previousId": 1,
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": true,
  "publishToSite": [
    1
  ],
  "userFilterEnabled": true,
  "allowedUsers": [
    {
      "account": "text",
      "type": [
        "1 = User",
        "2 = Group",
        "3 = ForeignSecurityPrincipal",
        "4 = Computer"
      ],
      "sid": "text"
    }
  ],
  "clientFilterEnabled": true,
  "allowedClients": [
    "text"
  ],
  "ipFilterEnabled": true,
  "allowedIP4s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "allowedIP6s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "macFilterEnabled": true,
  "allowedMACs": [
    "text"
  ],
  "allowedGateways": [
    "text"
  ],
  "osFilterEnabled": true,
  "allowedOSes": {
    "chrome": true,
    "android": true,
    "webClient": true,
    "iOS": true,
    "linux": true,
    "mac": true,
    "wyse": true,
    "windows": true
  },
  "preferredRoutingEnabled": true,
  "preferredRoutes": [
    {
      "id": 1,
      "priority": 1,
      "name": "text",
      "description": "text",
      "enabled": true,
      "referenceType": [
        "3 = Gateway",
        "51 = HALB",
        "83 = Custom"
      ],
      "referenceId": 1
    }
  ],
  "filter": {
    "rules": [
      {
        "id": 1,
        "priority": 1,
        "enabled": true,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": true,
              "android": true,
              "webClient": true,
              "iOS": true,
              "linux": true,
              "mac": true,
              "wyse": true,
              "windows": true
            }
          },
          "iPs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": [
              1
            ]
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": true,
  "excludePrelaunch": true,
  "inheritShortcutDefaultSettings": true,
  "createShortcutOnDesktop": true,
  "createShortcutInStartFolder": true,
  "startPath": "text",
  "createShortcutInStartUpFolder": true,
  "replicateShortcutSettings": true,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "publishFromServer": [
    1
  ],
  "publishFromHostPool": [
    1
  ],
  "perServerAttributes": [
    {
      "parameters": "text",
      "startIn": "text",
      "target": "text",
      "serverId": 1,
      "package": "text",
      "packagedApp": "text"
    }
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "enableFileExtensions": true,
  "inheritDisplayDefaultSettings": true,
  "replicateDisplaySettings": true,
  "startMaximized": true,
  "startFullscreen": true,
  "waitForPrinters": true,
  "waitForPrintersTimeout": 1,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritLicenseDefaultSettings": true,
  "replicateLicenseSettings": true,
  "replicateFileExtensionSettings": true,
  "replicateDefaultServerSettings": true,
  "disableSessionSharing": true,
  "oneInstancePerUser": true,
  "conCurrentLicenses": 1,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "fileExtensions": [
    {
      "extension": "text",
      "parameters": "text",
      "enabled": true
    }
  ]
}

Update

put

Modify properties of a published RD Session Host application.

Path parameters

idinteger · int32Required

ID of the published RD Session Host application to be updated

Body

Update settings of an application published from a RD Session Host

namestring | nullableOptional

A new name to assign to the published resource.

replicateMaintenanceboolean | nullableOptional

Replicate Maintenance

inheritMaintenanceboolean | nullableOptional

Inherit Maintenance

enabledboolean | nullableOptionalDeprecated

Enable or disable a published resource.

enabledModestring · enumOptional

Published resource availability modes.

Possible values:

maintenanceMessage_en_USstring | nullableOptional

Maintenance message for the published resource in English.

maintenanceMessage_ja_JPstring | nullableOptional

Maintenance message for the published resource in Japanese.

maintenanceMessage_fr_FRstring | nullableOptional

Maintenance message for the published resource in French.

maintenanceMessage_es_ESstring | nullableOptional

Maintenance message for the published resource in Spanish.

maintenanceMessage_it_ITstring | nullableOptional

Maintenance message for the published resource in Italian.

maintenanceMessage_pt_BRstring | nullableOptional

Maintenance message for the published resource in Portuguese.

maintenanceMessage_nl_NLstring | nullableOptional

Maintenance message for the published resource in Dutch.

maintenanceMessage_de_DEstring | nullableOptional

Maintenance message for the published resource in German.

maintenanceMessage_zh_TWstring | nullableOptional

Maintenance message for the published resource in Chinese (Traditional).

maintenanceMessage_zh_CNstring | nullableOptional

Maintenance message for the published resource in Chinese (Simplified).

maintenanceMessage_ko_KRstring | nullableOptional

Maintenance message for the published resource in Korean.

descriptionstring | nullableOptional

Published resource description.

publishToSiteIdsinteger · int32[] | nullableOptional

An array of sites to which to publish a resource.

ipFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable IP filters.

clientFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable client filters.

macFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable mac filters.

userFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable user filters.

gatewayFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable Secure Gateway filters.

osFilterEnabledboolean | nullableOptionalDeprecated

Enable or disable the OS filter.

allowClientChromeboolean | nullableOptionalDeprecated

Allow or not Chrome OS Clients.

allowClientAndroidboolean | nullableOptionalDeprecated

Allow or not Android Clients.

allowClientWebboolean | nullableOptionalDeprecated

Allow or not Web Clients.

allowClientIOSboolean | nullableOptionalDeprecated

Allow or not IOS Clients.

allowClientLinuxboolean | nullableOptionalDeprecated

Allow or not Linux Clients.

allowClientMACboolean | nullableOptionalDeprecated

Allow or not MAC Clients.

allowClientWindowsboolean | nullableOptionalDeprecated

Allow or not Windows Clients.

allowClientWyseboolean | nullableOptionalDeprecated

Allow or not Wyse Clients.

preferredRoutingEnabledboolean | nullableOptional

Enable or disable Preferred Routing.

replicateShortcutSettingsboolean | nullableOptional

Replicate shortcut settings to all sites.

createShortcutOnDesktopboolean | nullableOptional

Create a shortcut on a client's desktop.

createShortcutInStartFolderboolean | nullableOptional

Create a shortcut in the client's Start folder.

createShortcutInStartUpFolderboolean | nullableOptional

Create a shortcut in the client's Auto Start folder.

startPathstring | nullableOptional

Specifies the path in the Start folder where the shortcut will be created.

inheritShortcutDefaultSettingsboolean | nullableOptional

Inherit default shortcut settings.

startOnLogonboolean | nullableOptional

Start a resource automatically when a user logs on.

excludePrelaunchboolean | nullableOptional

Exclude application from prelaunch.

targetstring | nullableOptional

File name and path of a published application executable.

startInstring | nullableOptional

Folder name in which to start a published application.

parametersstring | nullableOptional

Optional parameters to pass to the published application executable.

packagestring | nullableOptional

The MSIX Package.

packagedAppstring | nullableOptional

The application within the MSIX package.

winTypestring · enumOptional

Published application window type

Possible values:

publishFromstring · enumOptional

Publish From' options for published items.

Possible values:

publishFromHostPoolIdsinteger · int32[] | nullableOptional

Specifies one or multiple host pool Ids from which to publish the application. The PublishFrom parameter must specify 1 (HostPool).

publishFromServerIdsinteger · int32[] | nullableOptional

One or multiple RDS Host server Ids from which to publish the application. The PublishFrom parameter must specify 2 (Host).

replicateDisplaySettingsboolean | nullableOptional

Enable or disable the 'Replicate settings' option (replicates display settings to all sites).

startMaximizedboolean | nullableOptional

Enable or disable the 'Start the application as maximized when using mobile clients" option.

startFullscreenboolean | nullableOptional

Enable or disable the 'Start in fullscreen mode for WYSE ThinOS clients" option.

waitForPrintersboolean | nullableOptional

Enable or disable the 'Wait until all RAS universal printers are redirected before showing the application" option.

waitForPrintersTimeoutinteger · int32 | nullableOptional

Printer redirection timeout (in seconds). Set this option when enabling the WaitForPrinters option.

colorDepthstring · enumOptional

Color Depth

Possible values:

inheritDisplayDefaultSettingsboolean | nullableOptional

Enable or disable the 'Inherit default settings" option for display properties.

replicateLicenseSettingsboolean | nullableOptional

Enable or disable the 'Replicate licensing settings" (settings are replicated to all sites).

disableSessionSharingboolean | nullableOptional

Enable or disable the 'Disable session sharing' option (licenses).

oneInstancePerUserboolean | nullableOptional

Enable or disable the 'Allow users to start only one instance of the application' option.

conCurrentLicensesinteger · int32 | nullableOptional

Specifies the 'Concurrent licenses' option (the number of concurrent licenses).

licenseLimitNotifystring · enumOptional

Defines actions to perform when the license limit is exceeded.

Possible values:

inheritLicenseDefaultSettingsboolean | nullableOptional

Enable or disable the 'Inherit default license settings' option.

enableFileExtensionsboolean | nullableOptional

Enable or disable the 'Enable File Extensions' option.

replicateFileExtensionSettingsboolean | nullableOptional

Enable or disable the 'Replicate settings' option (replicates extension settings to all sites).

replicateDefaultServerSettingsboolean | nullableOptional

Enable or disable the 'Replicate settings' option (replicates default server settings to all sites).

fileExtensionsstring | nullableOptional

List of file extensions to be added to the current list, if doesn't exist(comma separated values).

serverIdinteger · int32 | nullableOptional

Responses

204

No Content

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

put

HTTPcURLJavaScriptPython

PUT /api/PubItems/{id}/Apps/RDS HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 1811

{
  "name": "text",
  "replicateMaintenance": true,
  "inheritMaintenance": true,
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "maintenanceMessage_en_US": "text",
  "maintenanceMessage_ja_JP": "text",
  "maintenanceMessage_fr_FR": "text",
  "maintenanceMessage_es_ES": "text",
  "maintenanceMessage_it_IT": "text",
  "maintenanceMessage_pt_BR": "text",
  "maintenanceMessage_nl_NL": "text",
  "maintenanceMessage_de_DE": "text",
  "maintenanceMessage_zh_TW": "text",
  "maintenanceMessage_zh_CN": "text",
  "maintenanceMessage_ko_KR": "text",
  "description": "text",
  "publishToSiteIds": [
    1
  ],
  "preferredRoutingEnabled": true,
  "replicateShortcutSettings": true,
  "createShortcutOnDesktop": true,
  "createShortcutInStartFolder": true,
  "createShortcutInStartUpFolder": true,
  "startPath": "text",
  "inheritShortcutDefaultSettings": true,
  "startOnLogon": true,
  "excludePrelaunch": true,
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "publishFromHostPoolIds": [
    1
  ],
  "publishFromServerIds": [
    1
  ],
  "replicateDisplaySettings": true,
  "startMaximized": true,
  "startFullscreen": true,
  "waitForPrinters": true,
  "waitForPrintersTimeout": 1,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritDisplayDefaultSettings": true,
  "replicateLicenseSettings": true,
  "disableSessionSharing": true,
  "oneInstancePerUser": true,
  "conCurrentLicenses": 1,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "inheritLicenseDefaultSettings": true,
  "enableFileExtensions": true,
  "replicateFileExtensionSettings": true,
  "replicateDefaultServerSettings": true,
  "fileExtensions": "text",
  "serverId": 1
}

No content

Delete

delete

Delete a published application from a site.

Path parameters

idinteger · int32Required

ID of the published RD Session Host application to be deleted

Responses

204

No Content

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

delete

HTTPcURLJavaScriptPython

DELETE /api/PubItems/{id}/Apps/RDS HTTP/1.1
Host: 
Accept: */*

No content