RDS | Parallels REST API

Parallels REST API

Products Support Partners Documentation

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

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

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

200

401

404

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:51:42.585Z",
  "timeLastMod": "2025-04-06T01:51:42.585Z",
  "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
    }
  ]
}

Success

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

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

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

204

401

404

No Content

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

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/PubItems/Apps/RDS'

200

401

404

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:51:42.585Z",
  "timeLastMod": "2025-04-06T01:51:42.585Z",
  "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
    }
  ]
}

Success

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.

Available options:

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

Available options:

publishFromstring · enumoptional

Publish From' options for published items.

Available options:

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

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/PubItems/Apps/RDS' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "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": true,
    "winType": [
      "0 = Normal",
      "1 = Maximized",
      "2 = Minimized"
    ],
    "publishFrom": [
      "0 = All",
      "1 = HostPool",
      "2 = Host"
    ],
    "publishFromHostPoolIds": [
      1
    ],
    "publishFromServerIds": [
      1
    ]
  }'

201

401

409

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:51:42.585Z",
  "timeLastMod": "2025-04-06T01:51:42.585Z",
  "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
    }
  ]
}

Created

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.

Available options:

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

Available options:

publishFromstring · enumoptional

Publish From' options for published items.

Available options:

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

Available options:

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.

Available options:

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

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/PubItems/{id}/Apps/RDS' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "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
  }'

204

401

404

No Content