RDS

List

Retrieve a list of all the published RD Session Host applications

GET/api/PubItems/Apps/RDS

Query parameters

Response

200401404

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

maintenanceMessagesMaintenanceMessages (object)

Contains a set of maintenance messages in various languages

inheritMaintenanceboolean

Inherit Maintenance.

replicateMaintenanceboolean

Replicate Maintenance.

namenullable string

Name of the published item.

typeRASPubObject (enum)

RAS Publishing Objects

0 = Any,1 = Folder,2 = RDSApp,3 = RDSDesktop,4 = VDIDesktop,5 = PCDesktop,6 = PCApp,7 = VDIApp,8 = AVDApp,9 = AVDDesktop

parentIdinteger (int32)

ID of the parent folder of the published item.

previousIdinteger (int32)

ID of the previous published item.

descriptionnullable string

Description of the published item.

enabledModePubResourceEnabledMode (enum)

Published resource availability modes.

0 = Disabled,1 = Enabled,2 = Maintenance

enabledboolean

Whether the published item is enabled or not.

publishToSitenullable array of integer (int32)

List of the IDs of all the sites this item is published to.

userFilterEnabledboolean

Whether User Filtering is enabled or not (deprecated).

allowedUsersnullable array of UserFilter (object)

Lists the allowed users (deprecated).

clientFilterEnabledboolean

Whether Client Filtering is enabled or not (deprecated).

allowedClientsnullable array of string

Lists the allowed clients (deprecated).

ipFilterEnabledboolean

Whether IP Filtering is enabled or not (deprecated).

allowedIP4snullable array of IP4Range (object)

Lists the allowed IPv4 addresses (deprecated).

allowedIP6snullable array of IP6Range (object)

Lists the allowed IPV6 addresses (deprecated).

macFilterEnabledboolean

Whether MAC address Filtering is enabled or not (deprecated).

allowedMACsnullable array of string

Lists the allowed MAC addresses (deprecated).

allowedGatewaysnullable array of string

Lists the allowed Gateways (deprecated).

osFilterEnabledboolean

Whether OS Filtering is enabled or not (deprecated).

allowedOSesAllowedOperatingSystems (object)

Allowed Operating Systems

preferredRoutingEnabledboolean

Whether Preferred Routing is enabled or not.

preferredRoutesnullable array of PubPreferredRoute (object)

The list of Preferred Routes.

filterPubItemFilter (object)

The PubItem Filter object.

startOnLogonboolean

Whether the 'Start automatically when user logs on' option is enabled or disabled.

excludePrelaunchboolean

Exclude application from prelaunch.

inheritShortcutDefaultSettingsboolean

Whether to inherit default shortcut settings or not.

createShortcutOnDesktopboolean

Whether to create a shortcut on the desktop or not.

createShortcutInStartFolderboolean

Whether to create a shortcut in the start folder or not.

startPathnullable string

Starting path of the published item.

createShortcutInStartUpFolderboolean

Whether to create a shortcut in the startup folder or not.

replicateShortcutSettingsboolean

Whether to replicate shortcut settings or not.

winTypeWindowType (enum)

Published application window type

0 = Normal,1 = Maximized,2 = Minimized

targetnullable string

Application target file.

startInnullable string

Application working directory.

parametersnullable string

Application parameters.

packagenullable string

Application package

packagedAppnullable string

Application in the application package

publishFromServernullable array of integer (int32)

List of servers to publish from.

publishFromHostPoolnullable array of integer (int32)

List of host pools to publish from.

perServerAttributesnullable array of PubAppAttr (object)

Application settings per server.

publishFromPublishFrom (enum)

Publish From' options for published items.

0 = All,1 = HostPool,2 = Host

enableFileExtensionsboolean

Whether file extensions option is enabled or not.

inheritDisplayDefaultSettingsboolean

Whether the 'Inherit default license settings' option is enabled or disabled.

replicateDisplaySettingsboolean

Whether the 'Replicate Display Settings' is enabled or not.

startMaximizedboolean

Whether the application will start as maximized or not.

startFullscreenboolean

Whether the application will start as fullscreen for WYSE ThinOS clients or not.

waitForPrintersboolean

Whether the application will wait for the printers or not.

waitForPrintersTimeoutinteger (int32)

Timeout for waiting of the application for the printers.

colorDepthColorDepth (enum)

Color Depth

0 = Colors8Bit,1 = Colors15Bit,2 = Colors16Bit,3 = Colors24Bit,4 = Colors32Bit,5 = ClientSpecified

inheritLicenseDefaultSettingsboolean

Whether to inherit license default settings or not.

replicateLicenseSettingsboolean

Whether to replicate license settings or not.

replicateFileExtensionSettingsboolean

Whether to replicate file extension settings or not.

replicateDefaultServerSettingsboolean

Whether to replicate settings of the default server or not.

disableSessionSharingboolean

Whether to disable session sharing or not.

oneInstancePerUserboolean

Whether the option for one instance per user is enabled or not.

conCurrentLicensesinteger (int32)

Number of concurrent licenses.

licenseLimitNotifyLimitNotify (enum)

Defines actions to perform when the license limit is exceeded.

0 = WarnUserAndNoStart,1 = WarnUserAndStart,2 = NotifyAdminAndStart,3 = NotifyUserAdminAndStart,4 = NotifyUserAdminAndNoStart

fileExtensionsnullable array of PubFileExtSettings (object)

Lists extension settings for published applications.

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/Apps/RDS', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2024-11-07T07:40:37.196Z",
  "timeLastMod": "2024-11-07T07:40:37.196Z",
  "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": false,
  "replicateMaintenance": false,
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop"
  ],
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": false,
  "publishToSite": [],
  "userFilterEnabled": false,
  "allowedUsers": [
    {
      "account": "text",
      "type": [
        "1 = User",
        "2 = Group",
        "3 = ForeignSecurityPrincipal",
        "4 = Computer"
      ],
      "sid": "text"
    }
  ],
  "clientFilterEnabled": false,
  "allowedClients": [
    "text"
  ],
  "ipFilterEnabled": false,
  "allowedIP4s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "allowedIP6s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "macFilterEnabled": false,
  "allowedMACs": [
    "text"
  ],
  "allowedGateways": [
    "text"
  ],
  "osFilterEnabled": false,
  "allowedOSes": {
    "chrome": false,
    "android": false,
    "webClient": false,
    "iOS": false,
    "linux": false,
    "mac": false,
    "wyse": false,
    "windows": false
  },
  "preferredRoutingEnabled": false,
  "preferredRoutes": [
    {
      "name": "text",
      "description": "text",
      "enabled": false,
      "referenceType": [
        "3 = Gateway",
        "51 = HALB",
        "83 = Custom"
      ]
    }
  ],
  "filter": {
    "rules": [
      {
        "enabled": false,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": false,
              "android": false,
              "webClient": false,
              "iOS": false,
              "linux": false,
              "mac": false,
              "wyse": false,
              "windows": false
            }
          },
          "iPs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": []
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": false,
  "excludePrelaunch": false,
  "inheritShortcutDefaultSettings": false,
  "createShortcutOnDesktop": false,
  "createShortcutInStartFolder": false,
  "startPath": "text",
  "createShortcutInStartUpFolder": false,
  "replicateShortcutSettings": false,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "publishFromServer": [],
  "publishFromHostPool": [],
  "perServerAttributes": [
    {
      "parameters": "text",
      "startIn": "text",
      "target": "text",
      "package": "text",
      "packagedApp": "text"
    }
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "enableFileExtensions": false,
  "inheritDisplayDefaultSettings": false,
  "replicateDisplaySettings": false,
  "startMaximized": false,
  "startFullscreen": false,
  "waitForPrinters": false,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritLicenseDefaultSettings": false,
  "replicateLicenseSettings": false,
  "replicateFileExtensionSettings": false,
  "replicateDefaultServerSettings": false,
  "disableSessionSharing": false,
  "oneInstancePerUser": false,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "fileExtensions": [
    {
      "extension": "text",
      "parameters": "text",
      "enabled": false
    }
  ]
}

Create

Add a published RD Session Host application to a site.

POST/api/PubItems/Apps/RDS

Body

application/json; api-version=1.0

name*nullable string

Published resource name.

parentIdnullable integer (int32)

Parent publishing folder ID.

previousIdnullable integer (int32)

Previous published ID.

replicateMaintenancenullable boolean

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

inheritMaintenancenullable boolean

Whether to inherit default Maintenance settings.

enabledModePubResourceEnabledMode (enum)

Published resource availability modes.

0 = Disabled,1 = Enabled,2 = Maintenance

maintenanceMessage_en_USnullable string

Maintenance message for the published resource in English.

maintenanceMessage_ja_JPnullable string

Maintenance message for the published resource in Japanese.

maintenanceMessage_fr_FRnullable string

Maintenance message for the published resource in French.

maintenanceMessage_es_ESnullable string

Maintenance message for the published resource in Spanish.

maintenanceMessage_it_ITnullable string

Maintenance message for the published resource in Italian.

maintenanceMessage_pt_BRnullable string

Maintenance message for the published resource in Portuguese.

maintenanceMessage_de_DEnullable string

Maintenance message for the published resource in German.

maintenanceMessage_nl_NLnullable string

Maintenance message for the published resource in Dutch.

maintenanceMessage_zh_TWnullable string

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

maintenanceMessage_zh_CNnullable string

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

maintenanceMessage_ko_KRnullable string

Maintenance message for the published resource in Korean.

descriptionnullable string

Published resource description.

publishToSiteIdsnullable array of integer (int32)

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

siteIdinteger (int32)

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

targetnullable string

File name and path of a published application executable.

startInnullable string

Folder name in which to start a published application.

parametersnullable string

Optional parameters to pass to the published application executable.

packagenullable string

The MSIX package.

packagedAppnullable string

The Application within the MSIX Package.

startOnLogonboolean

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

winTypeWindowType (enum)

Published application window type

0 = Normal,1 = Maximized,2 = Minimized

publishFromPublishFrom (enum)

Publish From' options for published items.

0 = All,1 = HostPool,2 = Host

publishFromHostPoolIdsnullable array of integer (int32)

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

publishFromServerIdsnullable array of integer (int32)

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

Response

201401409

Created

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

maintenanceMessagesMaintenanceMessages (object)

Contains a set of maintenance messages in various languages

inheritMaintenanceboolean

Inherit Maintenance.

replicateMaintenanceboolean

Replicate Maintenance.

namenullable string

Name of the published item.

typeRASPubObject (enum)

RAS Publishing Objects

0 = Any,1 = Folder,2 = RDSApp,3 = RDSDesktop,4 = VDIDesktop,5 = PCDesktop,6 = PCApp,7 = VDIApp,8 = AVDApp,9 = AVDDesktop

parentIdinteger (int32)

ID of the parent folder of the published item.

previousIdinteger (int32)

ID of the previous published item.

descriptionnullable string

Description of the published item.

enabledModePubResourceEnabledMode (enum)

Published resource availability modes.

0 = Disabled,1 = Enabled,2 = Maintenance

enabledboolean

Whether the published item is enabled or not.

publishToSitenullable array of integer (int32)

List of the IDs of all the sites this item is published to.

userFilterEnabledboolean

Whether User Filtering is enabled or not (deprecated).

allowedUsersnullable array of UserFilter (object)

Lists the allowed users (deprecated).

clientFilterEnabledboolean

Whether Client Filtering is enabled or not (deprecated).

allowedClientsnullable array of string

Lists the allowed clients (deprecated).

ipFilterEnabledboolean

Whether IP Filtering is enabled or not (deprecated).

allowedIP4snullable array of IP4Range (object)

Lists the allowed IPv4 addresses (deprecated).

allowedIP6snullable array of IP6Range (object)

Lists the allowed IPV6 addresses (deprecated).

macFilterEnabledboolean

Whether MAC address Filtering is enabled or not (deprecated).

allowedMACsnullable array of string

Lists the allowed MAC addresses (deprecated).

allowedGatewaysnullable array of string

Lists the allowed Gateways (deprecated).

osFilterEnabledboolean

Whether OS Filtering is enabled or not (deprecated).

allowedOSesAllowedOperatingSystems (object)

Allowed Operating Systems

preferredRoutingEnabledboolean

Whether Preferred Routing is enabled or not.

preferredRoutesnullable array of PubPreferredRoute (object)

The list of Preferred Routes.

filterPubItemFilter (object)

The PubItem Filter object.

startOnLogonboolean

Whether the 'Start automatically when user logs on' option is enabled or disabled.

excludePrelaunchboolean

Exclude application from prelaunch.

inheritShortcutDefaultSettingsboolean

Whether to inherit default shortcut settings or not.

createShortcutOnDesktopboolean

Whether to create a shortcut on the desktop or not.

createShortcutInStartFolderboolean

Whether to create a shortcut in the start folder or not.

startPathnullable string

Starting path of the published item.

createShortcutInStartUpFolderboolean

Whether to create a shortcut in the startup folder or not.

replicateShortcutSettingsboolean

Whether to replicate shortcut settings or not.

winTypeWindowType (enum)

Published application window type

0 = Normal,1 = Maximized,2 = Minimized

targetnullable string

Application target file.

startInnullable string

Application working directory.

parametersnullable string

Application parameters.

packagenullable string

Application package

packagedAppnullable string

Application in the application package

publishFromServernullable array of integer (int32)

List of servers to publish from.

publishFromHostPoolnullable array of integer (int32)

List of host pools to publish from.

perServerAttributesnullable array of PubAppAttr (object)

Application settings per server.

publishFromPublishFrom (enum)

Publish From' options for published items.

0 = All,1 = HostPool,2 = Host

enableFileExtensionsboolean

Whether file extensions option is enabled or not.

inheritDisplayDefaultSettingsboolean

Whether the 'Inherit default license settings' option is enabled or disabled.

replicateDisplaySettingsboolean

Whether the 'Replicate Display Settings' is enabled or not.

startMaximizedboolean

Whether the application will start as maximized or not.

startFullscreenboolean

Whether the application will start as fullscreen for WYSE ThinOS clients or not.

waitForPrintersboolean

Whether the application will wait for the printers or not.

waitForPrintersTimeoutinteger (int32)

Timeout for waiting of the application for the printers.

colorDepthColorDepth (enum)

Color Depth

0 = Colors8Bit,1 = Colors15Bit,2 = Colors16Bit,3 = Colors24Bit,4 = Colors32Bit,5 = ClientSpecified

inheritLicenseDefaultSettingsboolean

Whether to inherit license default settings or not.

replicateLicenseSettingsboolean

Whether to replicate license settings or not.

replicateFileExtensionSettingsboolean

Whether to replicate file extension settings or not.

replicateDefaultServerSettingsboolean

Whether to replicate settings of the default server or not.

disableSessionSharingboolean

Whether to disable session sharing or not.

oneInstancePerUserboolean

Whether the option for one instance per user is enabled or not.

conCurrentLicensesinteger (int32)

Number of concurrent licenses.

licenseLimitNotifyLimitNotify (enum)

Defines actions to perform when the license limit is exceeded.

0 = WarnUserAndNoStart,1 = WarnUserAndStart,2 = NotifyAdminAndStart,3 = NotifyUserAdminAndStart,4 = NotifyUserAdminAndNoStart

fileExtensionsnullable array of PubFileExtSettings (object)

Lists extension settings for published applications.

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/Apps/RDS', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({
      "name": "text"
    }),
});
const data = await response.json();

Response

201401409

{
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2024-11-07T07:40:37.196Z",
  "timeLastMod": "2024-11-07T07:40:37.196Z",
  "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": false,
  "replicateMaintenance": false,
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop"
  ],
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": false,
  "publishToSite": [],
  "userFilterEnabled": false,
  "allowedUsers": [
    {
      "account": "text",
      "type": [
        "1 = User",
        "2 = Group",
        "3 = ForeignSecurityPrincipal",
        "4 = Computer"
      ],
      "sid": "text"
    }
  ],
  "clientFilterEnabled": false,
  "allowedClients": [
    "text"
  ],
  "ipFilterEnabled": false,
  "allowedIP4s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "allowedIP6s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "macFilterEnabled": false,
  "allowedMACs": [
    "text"
  ],
  "allowedGateways": [
    "text"
  ],
  "osFilterEnabled": false,
  "allowedOSes": {
    "chrome": false,
    "android": false,
    "webClient": false,
    "iOS": false,
    "linux": false,
    "mac": false,
    "wyse": false,
    "windows": false
  },
  "preferredRoutingEnabled": false,
  "preferredRoutes": [
    {
      "name": "text",
      "description": "text",
      "enabled": false,
      "referenceType": [
        "3 = Gateway",
        "51 = HALB",
        "83 = Custom"
      ]
    }
  ],
  "filter": {
    "rules": [
      {
        "enabled": false,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": false,
              "android": false,
              "webClient": false,
              "iOS": false,
              "linux": false,
              "mac": false,
              "wyse": false,
              "windows": false
            }
          },
          "iPs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": []
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": false,
  "excludePrelaunch": false,
  "inheritShortcutDefaultSettings": false,
  "createShortcutOnDesktop": false,
  "createShortcutInStartFolder": false,
  "startPath": "text",
  "createShortcutInStartUpFolder": false,
  "replicateShortcutSettings": false,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "publishFromServer": [],
  "publishFromHostPool": [],
  "perServerAttributes": [
    {
      "parameters": "text",
      "startIn": "text",
      "target": "text",
      "package": "text",
      "packagedApp": "text"
    }
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "enableFileExtensions": false,
  "inheritDisplayDefaultSettings": false,
  "replicateDisplaySettings": false,
  "startMaximized": false,
  "startFullscreen": false,
  "waitForPrinters": false,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritLicenseDefaultSettings": false,
  "replicateLicenseSettings": false,
  "replicateFileExtensionSettings": false,
  "replicateDefaultServerSettings": false,
  "disableSessionSharing": false,
  "oneInstancePerUser": false,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "fileExtensions": [
    {
      "extension": "text",
      "parameters": "text",
      "enabled": false
    }
  ]
}

Get

Retrieve a specified published RD Session Host application

GET/api/PubItems/{id}/Apps/RDS

Path parameters

id*integer (int32)

ID of the published RD Session Host application to be retrieved

Response

200401404

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

maintenanceMessagesMaintenanceMessages (object)

Contains a set of maintenance messages in various languages

inheritMaintenanceboolean

Inherit Maintenance.

replicateMaintenanceboolean

Replicate Maintenance.

namenullable string

Name of the published item.

typeRASPubObject (enum)

RAS Publishing Objects

0 = Any,1 = Folder,2 = RDSApp,3 = RDSDesktop,4 = VDIDesktop,5 = PCDesktop,6 = PCApp,7 = VDIApp,8 = AVDApp,9 = AVDDesktop

parentIdinteger (int32)

ID of the parent folder of the published item.

previousIdinteger (int32)

ID of the previous published item.

descriptionnullable string

Description of the published item.

enabledModePubResourceEnabledMode (enum)

Published resource availability modes.

0 = Disabled,1 = Enabled,2 = Maintenance

enabledboolean

Whether the published item is enabled or not.

publishToSitenullable array of integer (int32)

List of the IDs of all the sites this item is published to.

userFilterEnabledboolean

Whether User Filtering is enabled or not (deprecated).

allowedUsersnullable array of UserFilter (object)

Lists the allowed users (deprecated).

clientFilterEnabledboolean

Whether Client Filtering is enabled or not (deprecated).

allowedClientsnullable array of string

Lists the allowed clients (deprecated).

ipFilterEnabledboolean

Whether IP Filtering is enabled or not (deprecated).

allowedIP4snullable array of IP4Range (object)

Lists the allowed IPv4 addresses (deprecated).

allowedIP6snullable array of IP6Range (object)

Lists the allowed IPV6 addresses (deprecated).

macFilterEnabledboolean

Whether MAC address Filtering is enabled or not (deprecated).

allowedMACsnullable array of string

Lists the allowed MAC addresses (deprecated).

allowedGatewaysnullable array of string

Lists the allowed Gateways (deprecated).

osFilterEnabledboolean

Whether OS Filtering is enabled or not (deprecated).

allowedOSesAllowedOperatingSystems (object)

Allowed Operating Systems

preferredRoutingEnabledboolean

Whether Preferred Routing is enabled or not.

preferredRoutesnullable array of PubPreferredRoute (object)

The list of Preferred Routes.

filterPubItemFilter (object)

The PubItem Filter object.

startOnLogonboolean

Whether the 'Start automatically when user logs on' option is enabled or disabled.

excludePrelaunchboolean

Exclude application from prelaunch.

inheritShortcutDefaultSettingsboolean

Whether to inherit default shortcut settings or not.

createShortcutOnDesktopboolean

Whether to create a shortcut on the desktop or not.

createShortcutInStartFolderboolean

Whether to create a shortcut in the start folder or not.

startPathnullable string

Starting path of the published item.

createShortcutInStartUpFolderboolean

Whether to create a shortcut in the startup folder or not.

replicateShortcutSettingsboolean

Whether to replicate shortcut settings or not.

winTypeWindowType (enum)

Published application window type

0 = Normal,1 = Maximized,2 = Minimized

targetnullable string

Application target file.

startInnullable string

Application working directory.

parametersnullable string

Application parameters.

packagenullable string

Application package

packagedAppnullable string

Application in the application package

publishFromServernullable array of integer (int32)

List of servers to publish from.

publishFromHostPoolnullable array of integer (int32)

List of host pools to publish from.

perServerAttributesnullable array of PubAppAttr (object)

Application settings per server.

publishFromPublishFrom (enum)

Publish From' options for published items.

0 = All,1 = HostPool,2 = Host

enableFileExtensionsboolean

Whether file extensions option is enabled or not.

inheritDisplayDefaultSettingsboolean

Whether the 'Inherit default license settings' option is enabled or disabled.

replicateDisplaySettingsboolean

Whether the 'Replicate Display Settings' is enabled or not.

startMaximizedboolean

Whether the application will start as maximized or not.

startFullscreenboolean

Whether the application will start as fullscreen for WYSE ThinOS clients or not.

waitForPrintersboolean

Whether the application will wait for the printers or not.

waitForPrintersTimeoutinteger (int32)

Timeout for waiting of the application for the printers.

colorDepthColorDepth (enum)

Color Depth

0 = Colors8Bit,1 = Colors15Bit,2 = Colors16Bit,3 = Colors24Bit,4 = Colors32Bit,5 = ClientSpecified

inheritLicenseDefaultSettingsboolean

Whether to inherit license default settings or not.

replicateLicenseSettingsboolean

Whether to replicate license settings or not.

replicateFileExtensionSettingsboolean

Whether to replicate file extension settings or not.

replicateDefaultServerSettingsboolean

Whether to replicate settings of the default server or not.

disableSessionSharingboolean

Whether to disable session sharing or not.

oneInstancePerUserboolean

Whether the option for one instance per user is enabled or not.

conCurrentLicensesinteger (int32)

Number of concurrent licenses.

licenseLimitNotifyLimitNotify (enum)

Defines actions to perform when the license limit is exceeded.

0 = WarnUserAndNoStart,1 = WarnUserAndStart,2 = NotifyAdminAndStart,3 = NotifyUserAdminAndStart,4 = NotifyUserAdminAndNoStart

fileExtensionsnullable array of PubFileExtSettings (object)

Lists extension settings for published applications.

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/{id}/Apps/RDS', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2024-11-07T07:40:37.196Z",
  "timeLastMod": "2024-11-07T07:40:37.196Z",
  "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": false,
  "replicateMaintenance": false,
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop"
  ],
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": false,
  "publishToSite": [],
  "userFilterEnabled": false,
  "allowedUsers": [
    {
      "account": "text",
      "type": [
        "1 = User",
        "2 = Group",
        "3 = ForeignSecurityPrincipal",
        "4 = Computer"
      ],
      "sid": "text"
    }
  ],
  "clientFilterEnabled": false,
  "allowedClients": [
    "text"
  ],
  "ipFilterEnabled": false,
  "allowedIP4s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "allowedIP6s": [
    {
      "from": "text",
      "to": "text"
    }
  ],
  "macFilterEnabled": false,
  "allowedMACs": [
    "text"
  ],
  "allowedGateways": [
    "text"
  ],
  "osFilterEnabled": false,
  "allowedOSes": {
    "chrome": false,
    "android": false,
    "webClient": false,
    "iOS": false,
    "linux": false,
    "mac": false,
    "wyse": false,
    "windows": false
  },
  "preferredRoutingEnabled": false,
  "preferredRoutes": [
    {
      "name": "text",
      "description": "text",
      "enabled": false,
      "referenceType": [
        "3 = Gateway",
        "51 = HALB",
        "83 = Custom"
      ]
    }
  ],
  "filter": {
    "rules": [
      {
        "enabled": false,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": false,
              "android": false,
              "webClient": false,
              "iOS": false,
              "linux": false,
              "mac": false,
              "wyse": false,
              "windows": false
            }
          },
          "iPs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": false,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": []
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": false,
  "excludePrelaunch": false,
  "inheritShortcutDefaultSettings": false,
  "createShortcutOnDesktop": false,
  "createShortcutInStartFolder": false,
  "startPath": "text",
  "createShortcutInStartUpFolder": false,
  "replicateShortcutSettings": false,
  "winType": [
    "0 = Normal",
    "1 = Maximized",
    "2 = Minimized"
  ],
  "target": "text",
  "startIn": "text",
  "parameters": "text",
  "package": "text",
  "packagedApp": "text",
  "publishFromServer": [],
  "publishFromHostPool": [],
  "perServerAttributes": [
    {
      "parameters": "text",
      "startIn": "text",
      "target": "text",
      "package": "text",
      "packagedApp": "text"
    }
  ],
  "publishFrom": [
    "0 = All",
    "1 = HostPool",
    "2 = Host"
  ],
  "enableFileExtensions": false,
  "inheritDisplayDefaultSettings": false,
  "replicateDisplaySettings": false,
  "startMaximized": false,
  "startFullscreen": false,
  "waitForPrinters": false,
  "colorDepth": [
    "0 = Colors8Bit",
    "1 = Colors15Bit",
    "2 = Colors16Bit",
    "3 = Colors24Bit",
    "4 = Colors32Bit",
    "5 = ClientSpecified"
  ],
  "inheritLicenseDefaultSettings": false,
  "replicateLicenseSettings": false,
  "replicateFileExtensionSettings": false,
  "replicateDefaultServerSettings": false,
  "disableSessionSharing": false,
  "oneInstancePerUser": false,
  "licenseLimitNotify": [
    "0 = WarnUserAndNoStart",
    "1 = WarnUserAndStart",
    "2 = NotifyAdminAndStart",
    "3 = NotifyUserAdminAndStart",
    "4 = NotifyUserAdminAndNoStart"
  ],
  "fileExtensions": [
    {
      "extension": "text",
      "parameters": "text",
      "enabled": false
    }
  ]
}

Update

Modify properties of a published RD Session Host application.

PUT/api/PubItems/{id}/Apps/RDS

Path parameters

id*integer (int32)

ID of the published RD Session Host application to be updated

Body

application/json; api-version=1.0

Published RD Session Host application configuration

namenullable string

A new name to assign to the published resource.

replicateMaintenancenullable boolean

Replicate Maintenance

inheritMaintenancenullable boolean

Inherit Maintenance

enabledModePubResourceEnabledMode (enum)

Published resource availability modes.

0 = Disabled,1 = Enabled,2 = Maintenance

maintenanceMessage_en_USnullable string

Maintenance message for the published resource in English.

maintenanceMessage_ja_JPnullable string

Maintenance message for the published resource in Japanese.

maintenanceMessage_fr_FRnullable string

Maintenance message for the published resource in French.

maintenanceMessage_es_ESnullable string

Maintenance message for the published resource in Spanish.

maintenanceMessage_it_ITnullable string

Maintenance message for the published resource in Italian.

maintenanceMessage_pt_BRnullable string

Maintenance message for the published resource in Portuguese.

maintenanceMessage_nl_NLnullable string

Maintenance message for the published resource in Dutch.

maintenanceMessage_de_DEnullable string

Maintenance message for the published resource in German.

maintenanceMessage_zh_TWnullable string

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

maintenanceMessage_zh_CNnullable string

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

maintenanceMessage_ko_KRnullable string

Maintenance message for the published resource in Korean.

descriptionnullable string

Published resource description.

publishToSiteIdsnullable array of integer (int32)

An array of sites to which to publish a resource.

preferredRoutingEnablednullable boolean

Enable or disable Preferred Routing.

replicateShortcutSettingsnullable boolean

Replicate shortcut settings to all sites.

createShortcutOnDesktopnullable boolean

Create a shortcut on a client's desktop.

createShortcutInStartFoldernullable boolean

Create a shortcut in the client's Start folder.

createShortcutInStartUpFoldernullable boolean

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

startPathnullable string

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

inheritShortcutDefaultSettingsnullable boolean

Inherit default shortcut settings.

startOnLogonnullable boolean

Start a resource automatically when a user logs on.

excludePrelaunchnullable boolean

Exclude application from prelaunch.

targetnullable string

File name and path of a published application executable.

startInnullable string

Folder name in which to start a published application.

parametersnullable string

Optional parameters to pass to the published application executable.

packagenullable string

The MSIX Package.

packagedAppnullable string

The application within the MSIX package.

winTypeWindowType (enum)

Published application window type

0 = Normal,1 = Maximized,2 = Minimized

publishFromPublishFrom (enum)

Publish From' options for published items.

0 = All,1 = HostPool,2 = Host

publishFromHostPoolIdsnullable array of integer (int32)

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

publishFromServerIdsnullable array of integer (int32)

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

replicateDisplaySettingsnullable boolean

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

startMaximizednullable boolean

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

startFullscreennullable boolean

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

waitForPrintersnullable boolean

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

waitForPrintersTimeoutnullable integer (int32)

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

colorDepthColorDepth (enum)

Color Depth

0 = Colors8Bit,1 = Colors15Bit,2 = Colors16Bit,3 = Colors24Bit,4 = Colors32Bit,5 = ClientSpecified

inheritDisplayDefaultSettingsnullable boolean

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

replicateLicenseSettingsnullable boolean

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

disableSessionSharingnullable boolean

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

oneInstancePerUsernullable boolean

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

conCurrentLicensesnullable integer (int32)

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

licenseLimitNotifyLimitNotify (enum)

Defines actions to perform when the license limit is exceeded.

0 = WarnUserAndNoStart,1 = WarnUserAndStart,2 = NotifyAdminAndStart,3 = NotifyUserAdminAndStart,4 = NotifyUserAdminAndNoStart

inheritLicenseDefaultSettingsnullable boolean

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

enableFileExtensionsnullable boolean

Enable or disable the 'Enable File Extensions' option.

replicateFileExtensionSettingsnullable boolean

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

replicateDefaultServerSettingsnullable boolean

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

fileExtensionsnullable string

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

serverIdnullable integer (int32)

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/{id}/Apps/RDS', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "detail": "text",
  "instance": "text"
}

Delete

Delete a published application from a site.

DELETE/api/PubItems/{id}/Apps/RDS

Path parameters

id*integer (int32)

ID of the published RD Session Host application to be deleted

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/{id}/Apps/RDS', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "detail": "text",
  "instance": "text"
}