Amazon AppStream 2.0
Administration Guide

AppStream 2.0 Agent Version History

The Amazon AppStream 2.0 agent software runs on your streaming instances, enabling end users to connect to and start their streaming applications. Starting December 7, 2017, your streaming instances can be automatically updated with the latest features, performance improvements, and security updates that are available from AWS. Before December 7, 2017, agent updates were included with new base image releases.

To use the latest AppStream 2.0 agent software, you need to rebuild your images by using new base images published by AWS on or after December 7, 2017. When you do this, the option to enable automatic updates of the agent is selected by default in the Image Assistant. We recommend that you leave this option selected so that any new image builder or fleet instance that is launched from your image always uses the latest version of the agent. For more information, see Tutorial: Create a Custom AppStream 2.0 Image by Using the AppStream 2.0 Console.

The following table describes the latest updates that are available in released versions of the AppStream 2.0 agent.

Amazon AppStream 2.0 agent version Changes
11-13-2019
  • AppStream 2.0 assemblies are now signed, including executables and installer packages

  • Works with these software components:

    • Amazon SSM Agent — 2.3.701.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3519.0

10-08-2019
  • Modifies the AppStream 2.0 storage connector to no longer bypass the system proxy server

  • Works with these software components:

    • Amazon SSM Agent — 2.3.701.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3519.0

09-23-2019
  • Resolves an issue that occurs when launching applications that start child processes

  • Resolves an issue with directory traversal

  • Resolves an issue that causes the AppStream 2.0 agent to stop functioning, which prevents interaction with applications

  • Works with these software components:

    • Amazon SSM Agent — 2.3.701.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3519.0

09-03-2019
  • Adds support for applying IAM roles to AppStream 2.0 streaming instances. For more information, see Using an IAM Role to Grant Permissions to Applications and Scripts Running on AppStream 2.0 Streaming Instances

  • Adds support for specifying tags when creating AppStream 2.0 images programmatically with a command line interface

  • Modifies the AppStream 2.0 storage connector to bypass the system proxy server when mounting storage

  • Resolves an issue that prevented .lnk files from being specified in Image Assistant

  • Works with these software components:

    • Amazon SSM Agent — 2.3.612.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3429

08-08-2019
  • Adds support for AppStream 2.0 file system redirection. For more information, see Enable File System Redirection for Your AppStream 2.0 Users

  • Adds support for three new locales: English-United Kingdom (en-GB), English-Canada (en-CA), and English-Australia (en-AU)

  • Works with these software components:

    • Amazon SSM Agent — 2.3.612.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3429

07-26-2019
  • Adds support for creating and managing AppStream 2.0 images programmatically with a command line interface. For more information, see Create Your AppStream 2.0 Image Programmatically by Using the Image Assistant CLI Operations.

  • Image creation is no longer blocked when automatic Windows updates are enabled on an image builder. However, a message notifies administrators that automatic Windows updates will be disabled on the fleet in this case (that is, automatic Windows updates won't be enabled on fleet instances).

  • Disables Windows updates when a fleet instance starts

  • User accounts in the Administrators group are no longer disabled when an image builder instance starts

  • User accounts in the Administrators group are now disabled rather than deleted when an image builder instance starts

  • Resolves an issue that prevents the streaming resolution from resizing when network connections change

  • Resolves a race condition that prevents the streaming resolution from resizing when application settings persistence is enabled

  • Works with these software components:

    • Amazon SSM Agent — 2.3.612.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3429

06-19-2019
  • Adds support for Windows Server 2016 and Windows Server 2019 base images

  • AppStream 2.0 session scripts are now terminated after the configured timeout is exceeded

  • Resolves an issue where streaming instances may not be provisioned if the locale is changed

  • Includes a change to block image creation when automatic Windows updates are enabled on an image builder

  • Resolves an issue where streaming instances may take a long time to stop if the storage connector mount fails

  • Works with these software components:

    • Amazon SSM Agent — 2.3.612.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3429

05-07-2019
  • Adds support for subscribing to AppStream 2.0 usage reports. For more information, see AppStream 2.0 Usage Reports.

  • Adds support for configuring the amount of time that users can be idle (inactive) before they are disconnected from their streaming session. For more information, see "Create a Fleet" in Create an AppStream 2.0 Fleet and Stack.

  • Resolves an issue with using Amazon S3 buckets for home folder and application settings persistence with an Amazon S3 virtual private gateway

  • Includes a change to block image creation when automatic Windows updates are enabled on an image builder

  • Resolves an issue with persistent storage drives (home folders, OneDrive, and Google Drive) intermittently disappearing from the My Files dialog box

  • Works with these software components:

    • Amazon SSM Agent — 2.3.542.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3289

04-02-2019
  • Resolves an issue with session scripts and storage connector mounting

  • Resolves a minor issue with instance provisioning

  • Works with these software components:

    • Amazon SSM Agent — 2.3.344.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3067

03-07-2019
  • Adds support for gestures on touch-enabled iPads, Android tablets, and Windows devices

  • Resolves an issue with switching users in an image builder instance

  • Resolves an intermittent issue with instance reservations

  • Works with these software components:

    • Amazon SSM Agent — 2.3.344.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3067

01-22-2019
  • Adds support for using on-instance session scripts to run your own custom scripts when specific events occur in users' streaming sessions

  • Adds support for adding tags to the following AppStream 2.0 resource types during resource creation: image builders, images, fleets, and stacks

  • Includes a fix removing storage connector log files from the application settings persistence Virtual Hard Disk (VHD) file

  • Prevents image creation when the display language is changed from English and the AWS Command Line Interface (AWS CLI) version is earlier than 1.16.36. For more information, see "Special Considerations for Japanese Language Settings" in Configure Default Regional Settings for Your AppStream 2.0 Users.

  • Works with these software components:

    • Amazon SSM Agent — 2.3.344.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3067

01-08-2019
  • Improves the instance provisioning time for base images dated 01-08-2019

  • Works with these software components:

    • Amazon SSM Agent — 2.3.344.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.3067

12-19-2018
  • Resolves an issue with dynamic applications not being added to the application catalog

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

12-17-2018
  • The AppStream 2.0 client now supports a multiple-monitor experience for streaming instances that use a Graphics Design instance type

  • Resolves an issue with the temporary drive being visible on fleet instances that use a Graphics Desktop or Memory Optimized instance type

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

12-04-2018
  • Adds support for using a Japanese keyboard with web clients that run on Windows

  • Adds support for using the AppStream 2.0 dynamic application framework APIs to build a dynamic app provider

  • Resolves an issue with streaming the same session concurrently on multiple tabs or browsers

  • Includes a fix to make home folders, Google Drive, and OneDrive read-only until mounting is completed

  • Improves the mount time for home folders that are stored on fleet instances connected to an Amazon S3 VPC endpoint

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

11-14-2018
  • Adds support for launching streaming sessions using the AppStream 2.0 Windows client

  • Resolves an issue with opening applications that use environment variables for the fleet user name

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

10-30-2018
  • Resolves an issue with mounting home folders that are larger than 1 GB when application settings persistence is enabled

  • Resolves an issue with image creation when IPv6 is disabled

  • Session information is now provided as environment variables within streaming instances

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

10-24-2018
  • Includes a fix to display more than 1,000 files in the Amazon S3 home folders directory

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

10-01-2018
  • Improves the performance of application settings persistence

  • Includes a fix to unhide all drives on a fleet instance, except Drive C and Drive D, during user streaming sessions that are launched from the instance

  • Resolves an issue with accessing minimized application subwindows from the application switcher

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

08-29-2018
  • Adds support for application settings persistence

  • Resolves an issue with copying and pasting large amounts of data between applications within an AppStream 2.0 streaming session

  • Resolves an issue with accessing unresponsive applications from the application switcher

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

07-26-2018
  • Adds support for OneDrive persistent storage

  • Resolves an issue with saving Visio files to home folders and Google Drive

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

06-19-2018
  • Resolves an issue with optimizing images for application launch

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

06-06-2018
  • Adds support for regional settings and default application and Windows settings

  • Works with these software components:

    • Amazon SSM Agent — 2.2.619.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2644

05-31-2018
  • Adds support for Google Drive persistent storage

  • Works with these software components:

    • Amazon SSM Agent — 2.2.392.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2586

05-21-2018
  • Adds support for administrative controls for data transfer

  • Adds support for the Safari browser on macOS X

  • Works with these software components:

    • Amazon SSM Agent — 2.2.392.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2586

03-19-2018
  • Resolves an issue with minimizing the application window in certain environments

  • Works with these software components:

    • Amazon SSM Agent — 2.2.160.0

    • Amazon WDDM Hook Driver — 1.0.0.56

    • EC2Config service — 4.9.2400.0

01-24-2018
  • Resolves an issue with the Alt Graph key not working on certain keyboard layouts

  • Works with these software components:

    • Amazon SSM Agent — 2.2.93.0

    • Amazon WDDM Hook Driver — 1.0.0.50

    • EC2Config service — 4.9.2262.0

12-07-2017
  • Resolves issues with using ALT key combinations

  • Resolves an issue with file uploads from local computers to streaming sessions

  • Works with these software components:

    • Amazon SSM Agent — 2.2.93.0

    • Amazon WDDM Hook Driver — 1.0.0.21

    • EC2Config service — 4.9.2218.0