VMware Horizon Cloud Service | 20 APR 2017

As of February 7, 2017, the new brand name for VMware Horizon Air is Horizon Cloud with Hosted Infrastructure. In the current releases, customers will continue to find legacy references to previous names in the product documentation.

Release notes last updated on 14 NOV 2017

Check for additions and updates to these release notes.

Links to release notes for other versions (* indicates DaaS Agent): 15.3.2 | 15.3.3 | 16.6 | 16.6.1 | 16.6.2* | 16.11 | 16.11.1 | 16.11.2* | 17.1.1 | 17.2

What's in the Release Notes

The release notes cover the following topics:

New Features

New and Updated Options on the Assignments Page

There are a number of new options for assignments and VMs that can be accessed from the Assignments page.

Online/Offline Modes for Assignments

There is a new setting for taking assignments offline for maintenance and bringing them back online. Setting an Assignment to offline mode will prevent users from logging into the assignment desktops/applications. The setting also allows you to configure a custom maintenance notice for the assignment.

Note: At this time the custom maintenance notice appears only in the legacy Desktop Portal. Users launching through the HTML Access portal or through the Horizon Client directly will always see the default notice.

To take an assignment offline:

  1. On the Assignments page, select the assignment and click the Edit Assignment Mode button at the top of the page.

    The Edit Assignment Mode dialog appears.

  2. Change the Assignment Mode setting to Offline.

  3. If desired, enter a custom notice in the Maintenance Notice text box. If you do not enter a custom notice, users will see the default notice.

  4. Click Save.

To bring an assignment online:

  1. On the Assignments page, select the assignment and click the Edit Assignment Mode button at the top of the page.

    The Edit Assignment Mode dialog appears.

  2. Change the Assignment Mode setting to Online

  3. Click Save.

Restart Option for VMs

The Reboot button on the Servers or Desktops tab of the appliance detail page (tab displayed depends on assignment type--see above) has been replaced by a new Restart button. The new button performs a 'graceful' restart of the VM(s). If this does not work, it may be necessary to use the Reset option, which performs a hard reset of the VM and can result in data loss.

Updated Assign/Unassign Options for Dedicated Desktops

The workflow for assigning and unassigning dedicated desktops to users has been updated as follows.

To assign a dedicated desktop to a user:

  1. On the Assignments page, click on a dedicated desktops assignment.

  2. On the assignment detail page, select the Desktops tab.

  3. Check the check box next to the desktop.

  4. Click the Assign button.

  5. Search for the user in the Active Directory and click Save.

To unassign a dedicated desktop from a user:

  1. On the Assignments page, click on a dedicated desktops assignment.

  2. On the assignment detail page, select the Desktops tab.

  3. Check the check box next to the desktop.

  4. Click the ... button and select Unassign.

Rebuild Option for Floating Desktops

There is a new Rebuild option that deletes and recreates a desktop VM in a floating desktop assignment when the VM has become corrupted or otherwise non-operational. This option appears in the existing "..." menu on the Desktops tab of the assignment details page.

Other New Features in the User Interface

Update Agent Software for an Image

You can now update Agent software for Images in the user interface.

  • This functionality is substantially the same as the Update Agent Software option on the Assignments page.

  • This feature facilitates Agent Update on Instant Clone Assignments, which was not previously available.

Note the following:
  • This functionality requires Horizon Agent 7.0.3
  • If you have already set up Update Agent Software for Assignments, there is no further setup required.

For more information for setting up (if necessary) and using this feature, see Update Agent Software for an Image in the Images section of the Horizon Cloud with Hosted Infrastructure 17.1 Administration guide.

Update Agents on Instant Clone Assignments

You can now update agents on Dedicated Desktops - Instant Clone assignments by updating the image and pushing changes to the assignment using the new Update Agent Software for an Image feature described above.

Option to Allow User Access Through vIDM Only

There are new settings that you can use to require that remote and/or internal users to access desktops through an IDM.

To enable these option(s):

  1. Select Settings > General Settings.

  2. Click Edit.

  3. Confirm that the IDM is configured and in green state.

  4. Edit the IDM, selecting one or both of the new option(s):

    • Force Remote Users to vIDM - Blocks remote user access except through IDM.

    • Force Internal Users to vIDM - Blocks internal user access except through IDM.

Auxiliary Domain Bind Accounts

You can now configure additional domain bind accounts that can be used if the primary one is not operational for some reason. This is done by editing the Active Directory setup after it has already been set up. For more information, see Edit Active Directory in the Horizon Cloud with Hosted Infrastructure 17.1 Administration guide.

Enhanced Imported/Utility VM Functionality

Imported and Utility VMs can be described as follows:

  • Imported VMs - Unmanaged VMs with supported operating systems imported into Horizon Cloud to be converted into images or migrated to dedicated desktop assignments.

  • Utility VMs - Discovered VMs with unsupported operating systems used for infrastructure services such as DHCP.

The user interface had previously shown both Imported and Utility VMs together on the Utility VMs page, without distinguishing between the two types. Now each type of VM has its own page in the interface, as described below.

  • Imported VMs (Inventory > Imported VMs) - new page

    • Options for previously existing features, including Delete and Convert to Image.

    • Three new features:

      • The Restart button has replaced the Reboot button. The new button performs a 'graceful' restart of the VM(s), allowing you to recover hung VMs without loss of data. If this does not work, it may be necessary to use the Reset menu option, which performs a hard reset of the VM and can result in data loss.

      • Migrate to Utility VMs (menu option) - Moves the VM to the Utility VMs page.

      • Migrate to Assignment (menu option) - Associates the VM with a dedicated desktops assignment.

      For more information, see Imported VMs in the Horizon Cloud with Hosted Infrastructure Administration guide.

  • Utility VMs (Settings > Utility VMs) - updated page

    • Menu no longer includes Delete or Convert to Image options, which are specific to Imported VMs.

    • Includes two new features:

      • The Restart button has replaced the Reboot button. The new button performs a 'graceful' restart of the VM(s), allowing you to recover hung VMs without loss of data. If this does not work, it may be necessary to use the Reset menu option, which performs a hard reset of the VM and can result in data loss.

      • Migrate to Imported VMs (menu option) - Moves the VM to the Imported VMs page.

      For more information, see Managing Utility VMs in the Horizon Cloud with Hosted Infrastructure Administration guide.

Enhanced Export Functionality

Data export functionality, already available on several user interface pages, has been enhanced as follows.

  • When the user clicks the export icon, if filters have been applied to the data on the page, they are given a choice whether to export all data or only the filtered data shown.

  • Data is now exported to a directory of the user's choice as a comma-separated value file contained in a .zip file.

Direct Admin Connection to VMs

Administrators can now connect to desktops using their domain accounts, instead of being required to have local admin access. To allow this, a new DaaS Direct Connect Users group will be created during the DaaS Agent installation. This group does not have local administration rights, but is allowed to connect to the desktop through the Helpdesk Console or using a direct RDP connection.

There are two methods for adding a user to the DaaS Direct Connect Users group: by updating the image or by using a GPO policy on the tenant appliance.

To add members by updating the image:

  1. Join the image VM to the domain and then restart it.

  2. Add domain user(s) to the DaaS Direct Connect Users group.

  3. Publish the image and provision desktops. All desktops created using the image will now have the group member details.

To add members using a GPO policy on the tenant appliance:

  1. Create a new GPO.

  2. Right-click on the GPO and select Edit.

  3. In the Group Policy Management Editor, navigate to Computer Configuration > Policies > Windows Settings > Security Settings > Restricted Groups.

  4. Right-click Restricted Groups and select Add Group.

  5. In the Add Group dialog, enter DaaS Direct Connect Users and click OK.

  6. In the properties dialog, enter members in the Members of this group text box click Add, then click OK.

  7. Close the Group Policy Management Editor and the Group Policy Management Console.

  8. Link the newly created GPO to the domain.

Unified End User Preference Experience Across Clients

User preferences are now saved across clients, so if a user sets preferences in one client and logs in later on a different client, the preferences will persist.

Windows Server 2016 Supported

Windows Server 2016 is now a supported operating system for RDSH images, remote applications, and VDI desktops.

Smart Policies Integration

Horizon Cloud now supports Smart Policies, which can be used to create policies that control the behavior of the USB redirection, virtual printing, clipboard redirection, client drive redirection, and PCoIP display protocol features on specific remote desktops.

With Smart Policies, you can create policies that take effect only if certain conditions are met. For example, you can configure a policy that disables the client drive redirection feature if a user connects to a remote desktop from outside your corporate network.

For detailed information on setting up this feature, see Configuring VMware Horizon Smart Policies in the Horizon Cloud with Hosted Infrastructure 17.1 Administration guide.

VMware Blast Extreme

The Unified Access Gateway includes Blast Extreme Adaptive Transport (BEAT) networking, which dynamically adjusts to network conditions such as varying speeds and packet loss.

Image Sync Across Desktop Managers

If you have multiple Desktop Managers registered to a Tenant within the same Data Center, the Image Sync option can automatically sync images across the desktop managers.

Image Sync is disabled by default, and can be enabled/disabled for each Tenant by your VMware representative.

When enabled, Image Sync automatically does the following.

  • Duplicates new images across Desktop Managers, so you do not have to manually clone and import the images.

  • Syncs changes to images across Desktop Managers, so you do not have to make the changes on all copies.

Note the following:

  • Images that you created before Image Sync is enabled will not be automatically synced. You will have to take them offline and then republish them for the sync to occur.

  • If you have synced images and then have the feature disabled, for each of the synced images an additional image will appear in the list with a name similar to the synced image.

Access to Provisioning VMs via Helpdesk Console (Beta feature)

You can access desktop VMs that are still in the provisioning process using the console access feature of the Helpdesk Console, which is a Beta feature in this release. This includes desktops that are in the cloning (Instant Clone VMs only), domain join, or customization phase of the process, and allows you to see if any issues are occurring with the provisioning.

Top of Page

Other Changes in this Release

RDSH Role-Enabled Images Not Available for Creating Dedicated or Floating Desktop Assignments

Beginning in this release, RDSH role-enabled images will not be available for creating dedicated or floating desktops assignments. This will not cause any loss in functionality, since there is no reason for users to create dedicated or floating desktops assignments using such images.

/system/login REST API Deprecated

The /system/login REST API is deprecated and will be deleted in a future release. Instead, you can call https://<spip>/dt-rest/v100/system/platform and find in the response the authentication mechanism returned in the DtVersion getLoginFirstStep method (highlighted in the sample response below). The relevant tags to look for are: <DtCredentials>, <DtRSASecureIDPasscode>, and <DtRadiusPasscode>.

Sample response:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <DtVersion latest="true" id="v100">
        <DtLink href="/system" method="GET" name="DtSystemManager" rel="top"/>
        <DtLink href="/setting/manager" method="GET" name="DtSettingsManager" rel="top"/>
        <DtLink href="/example/top" method="GET" name="DtTopLevelManagerImpl" rel="top"/>
        <DtLink href="/install/manager" method="GET" name="DtInstallManager" rel="top"/>
        <DtLink href="/maintenance/manager" method="GET" name="DtMaintenanceManager" rel="top"/>
        <DtLink href="/install/orchestrationengine" method="GET" name="DtOrchestrationEngine" rel="top"/>
        <DtLink href="/notification/manager" method="GET" name="DtNotificationManager" rel="top"/>
        <DtLink href="/reporting/manager" method="GET" name="DtReportingManager" rel="top"/>
        <DtLink href="/infrastructure/manager" method="GET" name="DtInfrastructureManager" rel="top"/>
        <DtLink href="/mapping/manager" method="GET" name="DtMappingManager" rel="top"/>
        <DtLink href="/pool/manager" method="GET" name="DtPoolManager" rel="top"/>
        <DtLink href="/quota/manager" method="GET" name="DtQuotaManager" rel="top"/>
        <DtLink href="/reservation/manager" method="GET" name="DtReservationStatusManager" rel="top"/>
        <DtLink href="/session/manager" method="GET" name="DtSessionManager" rel="top"/>
        <DtLink href="/task/manager" method="GET" name="DtTaskManager" rel="top"/>
        <DtLink href="/truesso/manager" method="GET" name="DtTrueSsoConfigManager" rel="top"/>
        <DtLink href="/security/manager" method="GET" name="DtSecurityManager" rel="top"/>
        <DtCredentials type="CREDENTIALS"> <DtLink href="/system/authenticate/credentials" method="POST" name="Submit" rel="action"/> </DtCredentials>

Other REST APIs Deprecated

The methods listed below have been deprecated and will be deleted in the near future.

API URL API Class::Method
/infrastructure/manager/patterns DtInfrastructureManagerImpl :: getPatterns
/infrastructure/manager/create/pool DtInfrastructureManagerImpl :: createDesktopPool
/infrastructure/manager/pools DtInfrastructureManagerImpl :: getDesktopPools
/infrastructure/manager/mapping/users/pool DtInfrastructureManagerImpl :: getDesktopPoolOfUsers
/infrastructure/manager/mapping/users/pattern DtInfrastructureManagerImpl :: getPatternsOfUsers
/infrastructure/manager/mapping/users/default DtInfrastructureManagerImpl :: getDefaultMappingOfUsers
/infrastructure/manager/vms DtInfrastructureManagerImpl :: getVirtualMachines
/infrastructure/manager/vm DtInfrastructureManagerImpl :: getVirtualMachine
/infrastructure/manager/convert/gold DtInfrastructureManagerImpl :: convertToGoldPattern
/infrastructure/manager/reserve/pattern DtInfrastructureManagerImpl :: reserveDesktopPattern
/infrastructure/manager/recycle/purge DtInfrastructureManagerImpl :: purgeRecyclePool
/infrastructure/manager/poolrefresh DtInfrastructureManagerImpl :: refreshDynamicPool

Product Support Notices

New DaaS Agent and Horizon Agent

The following new agent versions are available:

  • DaaS Agent 17.1

  • Horizon 7.2 Agent (required by the above agent)

It is recommended that you upgrade to DaaS Agent 17.1 and Horizon 7.2 Agent once your platform has been upgraded to Horizon Cloud 17.1. If the environment has an older Horizon Agent, the DaaS Agent and Horizon Agent should be upgraded simultaneously.

Best Practices

Adding Users and Groups to RDSH Desktop and Application Assignments

For RDSH Desktop and Application assignments, if Active Directory user or group entitlements are added to an existing assignment, it is necessary to restart the DaaS Agent on the RDSH server in order to enable access to the desktop/apps for the newly added users.

App Volumes Not Supported for Dedicated Desktops - Traditional Clone Assignments

Use of App Volumes is not supported for Dedicated Desktops - Traditional Clone assignments. App Volumes can be used with Instant Clone assignments only.

Scanner Redirection in Virtual Desktops Not Supported

Scanner redirection in virtual desktops is not supported in this release – When you install the Horizon Agent, do not install the scanner redirection feature or unexpected results in virtual desktops might occur.

Resolved Issues

The following issues have been resolved in version 17.1.

  • Users had been unable to export activity data for assignments. This has been remedied so the export function works as expected on both the System Activity and User Activity tabs.
  • When a group was added to a Floating Desktops assignment, individual users were sometimes appearing on the assignment as well. This has been remedied so that only the group is shown. [1735126]
  • When you edited Roles & Permissions from the Getting Started page, if you selected Demo Administrator from the Role drop-down menu and clicked X next to the last remaining group, the Save button dimmed, preventing you from deleting the group. This issue has been remedied so editing works as expected. [1765091]

Known Issues

  • Client drive redirection does not work with Horizon Agent installed on a 32-bit Windows 10 operating system.

    Workaround: None. This is a Microsoft Windows Server issue. [1800375]

  • When you delete an image on the Images page, the status may display as "Error: Failed to create Image" for approximately two minutes after the deletion. This happens even though the delete operation was successful.

    Workaround: Refresh the page using the refresh feature in the user interface (not the refresh feature in your browser). If necessary, refresh multiple times until the page displays as expected. [1808079]

  • When you add a custom application without uploading an icon file, it can cause the operation to fail.

    Workaround: Include an icon file when you add the new custom app. [1841533]

  • Usernames that contain special characters can cause actions you perform on assignments (i.e. expand, shrink, delete, update) to fail.

    Workaround: Remove special characters from usernames in your system. [1839294]

  • AppStacks with names containing some non-English characters can fail to import successfully.

    Workaround: Rename AppStacks with English names. [1815669]

  • A very small number of users have reported failures when attempting to upgrade from Horizon Agent 7.0.3 to Horizon Agent 7.1.0.

    Workaround: Re-try the upgrade or reinstall the new agent. [1829688]

  • The User Portal Timeout setting in General Settings is only being applied to the legacy Desktop Portal and not to the HTML Access Portal as expected.

    Workaround: None [1771692]

  • For Dedicated desktop assignments, after the user's first login to a particular desktop, after disconnection they are not able to re-connect to that desktop by clicking the link on the Recent page in the Horizon Client.

    Workaround: User can reconnect by selecting the desktop from the main list, or close and relaunch the Horizon client. This only impacts the initial launch of a particular dedicated desktop; subsequent launches of that desktop will not exhibit this problem. [1813881]

  • For Dedicated Desktops - Instant Clone assignments, using the Update Agent Software feature to update the Horizon Agent fails, and also causes any other agents being updated together with the Horizon Agent to fail.

    Workaround: None [1849770]

  • Some desktop VMs are going into an 'untrusted' state after being deployed.

    Workaround: There is not a workaround you can perform yourself, but your VMware representative is able to correct this problem for you upon request. [1828958]


  • Incorrect value may display in the Users column on the Assignments page for a Native Application assignment created before the 17.1 upgrade.

    Workaround: Delete and re-create the assignment after the 17.1 upgrade. [1845930]

  • Some attach/detach failures that are occurring are not being reported on the Notifications page. These same failures are not returned when you use the script for retrieving attach/detach failures.

    Workaround: None [1803721]

check-circle-line exclamation-circle-line close-line
Scroll to top icon