For a pod in Microsoft Azure, you can use the Import Virtual Machine – Marketplace wizard to create the virtual machine (VM) using an operating system image from the Microsoft Azure Marketplace. In the process, the VM is automatically configured with the elements and agent-related software required to conform to the Horizon Cloud environment's requirements. At the end of the creation process, the VM is listed on the Imported VMs page and you can take further actions on it, such as pairing the VM with the cloud plane, customizing the VM, installing additional drivers, and so on.

Pods of different manifest versions require different subsequent steps on the VM that results from the Import Virtual Machine wizard.

Pod manifests 1600 and later
Starting with pod manifest 1600, the automated workflow results in a VM that is not yet paired with Horizon Cloud. After the VM is created and listed on the Imported VMs page, you use the Reset Agent Pairing action on it to pair it with the cloud plane.
Pod manifests earlier than 1600
When the wizard creates a VM in a pod with a manifest earlier than 1600, the automated workflow pairs the VM with the cloud plane in the process. At the end of the process, the resulting VM is listed on the Imported VMs page with the agent in the active state.
Remember: Like all of the console, this wizard's user interface is dynamic. The wizard's displayed selections and options will automatically change as you go through the wizard selecting items in lists and enabling or deactivating toggles. The wizard's displayed items will also reflect what your Horizon Cloud tenant account is licensed to use. If you read something here and you do not see it as you go through the wizard in real time, try changing a selection that is set in the upper portion of the wizard to see how the wizard's options change. After trying that, if you still do not see what is described, then that item most probably does not apply to your account's configuration.

By default, the system enables Optimize Windows Image, regardless of operating system. For non-multi-session Windows 10 operating systems, the system also enables Remove Windows Store Apps by default. Keeping those options enabled is strongly recommended to help prevent you from encountering Microsoft Windows Sysprep issues that might occur when the VM is later published as an image.

Also by default, in the Advanced Options section, the wizard enables the various toggles to install those agent-related custom setup options that are both appropriate and relevant according to your other selections in the wizard, and which are supported for use in the Horizon Cloud environment with the selected operating system. If you want to change the default selections, expand the Advanced Options section in the Import Virtual Machine – Marketplace window and set the toggles according to your needs.

As an example, an agent option that provides 3D support only in operating systems that support RDS or multi-session use cases is enabled by default in the Advanced Options section only when you have selected one of those operating systems in the OS drop-down list. When you have selected a client operating system for VDI use cases, in which that agent option is not applicable, that agent option is not selected for installation.

Tip: Starting with the December 2019 service release, the Import Virtual Machine wizard provides the option of either having the wizard-created VM joined to a specified Active Directory domain or not having the VM joined to the domain at the end of the creation process. Prior to the December 2019 service release, the wizard-created VM was always automatically joined to an Active Directory domain that you specified in the wizard.

However, due to a known issue, if you are using the wizard with a pod of manifest earlier than 1600, you should enable the Domain Join option and have the wizard join the VM to a domain. Until the known issue is fixed, if you are using the wizard to create a VM in a pod with a manifest lower than 1600 and you switch off the Domain Join toggle, the import VM process fails in the final steps of the process. For updated information about this issue, see the December 2019 release information in the Release Notes. The Release Notes page is linked from the Horizon Cloud documentation page.

Prerequisites

Important: When you are importing the VM intending to use it with the App Volumes features, make sure that you explicitly enable the Domain Join toggle. Domain joining the imported VM is a requirement for using App Volumes with it and that toggle is not set by default. You must explicitly enable that toggle.

Tech Preview: Use of App Volumes with Microsoft Windows 10 Enterprise multi-session is currently in tech preview. During this tech preview, use of the wizard's App Volumes Agent toggle to install the App Volumes Agent into the base VM is not provided when OS is set to one of the Microsoft Windows 10 Enterprise multi-session operating systems. When one of those operating systems is selected in this wizard's OS field, that toggle is not visible in the Advanced Options section. In this case, after you see the imported VM is successfully imported on the Imported VMs page, you must perform some additional steps to configure the imported VM with the App Volumes Agent. See Tech Preview - How To Configure a Microsoft Windows 10 Multi-Session Image for Use with App Volumes Features in Horizon Cloud Pods in Microsoft Azure.

Procedure

  1. On the Imported VMs page, click Import.
  2. In the Import wizard, choose the pod in which to create the VM by first selecting the pod's associated location and then selecting the pod from the list of pods at that location.
    After you select a location, the choices in the Pod list are filtered to show the pods available in the selected location.
    Important: If you are planning to use this image for GPU-enabled desktops or remote applications, ensure that the selected pod resides in a Microsoft Azure region that supports GPU-enabled virtual machines (VMs). GPU-enabled VMs are only available in some Microsoft Azure regions. See Microsoft Azure Products by region for details.
  3. Select the details for the base VM.
    Option Description
    OS Select the Microsoft Windows operating system to use for the image's underlying VM.
    Note: This drop-down menu takes a few moments to populate the entries.
    • If you are going to use this image for VDI desktops, select one of the non-server, non-multi-session operating systems that are listed in the drop-down list. To create a VDI desktop image, do not select one of those server or multi-session types of operating systems.
    • If you are going to use this image for provisioning items that support shared usage, such as RDSH session desktops or RDS-based remote applications, select one of the listed server or multi-session operating systems.
    Include GPU Enable this toggle to specify a GPU-enabled VM for this base VM. This option is not supported for the Windows 7 operating system. Therefore, you will not see this wizard option due to the dynamic nature of the wizard if you selected a Windows 7 operating system.
    Important: When enabling GPU, after the base VM is created, you must log into the VM's operating system and install the supported NVIDIA graphics drivers to get the GPU capabilities of the Microsoft Azure GPU-enabled VM. You install the drivers after the VM import process is completed.

    If this VM is created in a pod at manifest 1600 or later, you usually install the drivers after using the Reset Agent Pairing action on the VM as described in Step 9 below.

    Domain Join Enable this toggle to specify that the resulting VM will be joined to one of Active Directory domains that are registered with your Horizon Cloud tenant as part of the automated process. When enabled, select the Active Directory domain from the drop-down list. The resulting VM will be joined to the selected domain. Domain administrator accounts in that domain will be able to log in to the resulting VM.

    When this toggle is switched off, the resulting VM is not joined to an Active Directory domain. Only the account credentials that you specify in this wizard can be used to log in to the resulting VM.

    Important: When you are planning to use this VM for provisioning App Volumes applications, you must enable the Domain Join toggle. Installation of the App Volumes Agent requires the VM to be joined to the domain.
    Enable Public IP Address Enable this toggle to configure a public IP address for this base VM. When enabled, the VM gets both a private IP address and a public one.

    When this toggle is switched off, the VM is configured with only a private IP address in your Microsoft Azure environment.

    Optimize Windows Image By default, this toggle is enabled to create a base VM that meets VMware recommendations and best practices for optimizing a VM's Microsoft Windows operating system. This optimization includes adjusting default operating system services features to meet the best practices, such as:
    • Deactivating physical desktop features that are irrelevant in a virtual environment, to provide more efficient VM performance.
    • Deactivating certain Windows system services, such as Windows Update, so that control of that service is isolated to administrators instead of the end users.

    For more details, see Deciding to Optimize the Windows Image When Using the Import Virtual Machine from Marketplace Wizard.

    Important: Keeping the default setting is strongly recommended to help prevent you from encountering Microsoft Windows Sysprep issues that might occur when the VM is later published as an image.
    Remove Windows Store Apps This toggle is visible only when OS is set to a non-multi-session Windows 10 operating system. By default, this toggle is enabled to create a base VM that:
    • Deactivates the Windows Store Installer Service.
    • Removes most of the Windows Store applications that come in those base Windows 10 operating systems by default. These Windows 10 default applications are ones provided by AppX packages in the operating system.
    Important:
    • Even when the toggle is enabled, the system retains some AppX packages by default, based on a system-defined allowed list. These allowed AppX packages remain installed in the VM at the end of the import VM process. For the list, visit the topic link below.
    • Keeping the default setting is strongly recommended to help prevent you from encountering Microsoft Windows Sysprep issues that might occur when the VM is later published as an image.

    For more details, see Using the Remove Windows Store Apps Option When Using the Import Desktop Wizard.

  4. Provide administration details.
    Note: The user name and password you enter must meet the Microsoft requirements for acceptable user names and passwords for creating a VM in Microsoft Azure. For the list of requirements, see username requirements and password requirements in the Microsoft documentation.
    Option Description
    Username Type the admin name that you want for the VM's local administrator account. This local administrator account is created in the VM during the process. This name will be used for the local admin account to access the VM's operating system, and also used during the convert to image process. This name can be a maximum of 15 characters in length, must not end in a period ("."), and must not be one of the admin names that are not allowed when creating a VM in Microsoft Azure.
    Important: Ensure you can remember this local administrator account information (this name and the password that you specify in the Password text box), or that you write it down so you can retrieve the information later. You will need these credentials when you want to add any third-party applications to this base image and when performing the New Image workflow to publish this image to the system.
    Password Type the password that you want for that administrator account. The password must adhere to the Microsoft Azure password rules:
    • Must not be one of the admin account passwords that are not allowed when creating a VM in Microsoft Azure
    • Must be from 12 through 123 characters in length and meet three out of the following four complexity requirements:
      • Contain a lowercase character
      • Contain an uppercase character
      • Contain a digit
      • Contain a special character, such as (!@#$%/^&*)
    Verify Password Re-type the password.
    Windows license question

    As you go through making selections in the wizard's user interface, the wizard might display this question in the form of a toggle and check box combination. Follow the on-screen guidance. As described in Licensing section of VMware Horizon Cloud Service on Microsoft Azure Requirements Checklist For New Pod Deployments, Horizon Cloud does not provide any guest operating system licensing required for use of Microsoft Windows operating systems that you use in the course of using the Horizon Cloud workflows. You, the customer, have the responsibility to have valid and eligible Microsoft licenses that entitle you to create the Windows-based desktop VMs and RDSH VMs that you choose to use in your Horizon Cloud tenant environment.

  5. In the Name field, provide a name for the VM and an optional description.
    Important: Do not enter a name that was previously used for an imported VM that has been converted into an assignable image in your Horizon Cloud environment. For example, if an imported VM was converted into an assignable image so that it is listed on the Images page, do not enter the same name here. Due to a known issue, the VM creation process fails silently if you reuse a name that is already listed on the Images page. The system will not create the VM in Microsoft Azure, however, an error message does not appear in the administrative console.

    The name must adhere to the following rules:

    • It cannot contain an underscore character (_).
    • It can have only alphanumeric characters and the hyphen.
    • The name must start with an alphabetic character (not a number).
    • The name cannot end with a hyphen (-).
  6. Use the toggles in the Advanced Options section to customize the Horizon agent features that will be installed in the VM.
    When the option's toggle is enabled, the corresponding feature will be installed in the VM. In addition to the options you see selected in this wizard, the workflow process always installs the following key features by default.
    • Horizon agent - HTML5 Multimedia Redirection. Redirects HTML5 multimedia content in a Chrome or Edge browser to the user's local system to optimize performance.
    • Horizon agent - Horizon Performance Tracker. Monitors the performance of the display protocol and system resource usage.
    • Horizon agent - vRealize Operations Desktop Agent. Collects activity-related data from user sessions in the desktop instance or farm RDSH VMs based on this image, and sends that data to the Horizon Cloud cloud monitoring service (CMS) for historical data collection and reporting.
    • VMware Dynamic Environment Manager client components. The FlexEngine client component is installed using its typical mode. This feature enables use of VMware Dynamic Environment Manager features with the desktop VMs and RDSH VMs that are provisioned based on this image.
    Attention: For the Windows 7 Enterprise operating system, the only optional agent features that can be installed using the toggles are the USB Redirection and Help Desk options. Also, even though the system will install the preceding four agent features into a Windows 7 Enterprise VM by default, the HTML5 Multimedia Redirection option and Horizon Performance Tracker are not supported for use in Windows 7 Enterprise.
    Option Description
    App Volumes Agent The wizard makes this toggle available when the OS choice is set to a client operating system and the Domain Join toggle is enabled. Enable this toggle to install the App Volumes Agent in the base VM to support having images with the ability to provision native applications for end-user VDI desktops.
    Note: Tech Preview: Use of App Volumes with Microsoft Windows 10 Enterprise multi-session is currently in tech preview. During this tech preview, use of the wizard's App Volumes Agent toggle to install the App Volumes Agent into the base VM is not provided when OS is set to one of the Microsoft Windows 10 Enterprise multi-session operating systems. As a result, this toggle is not visible when one of those operating systems is selected. In this case, after you see the imported VM is successfully imported on the Imported VMs page, you must perform some additional steps to configure the imported VM with the App Volumes Agent. See Tech Preview - How To Configure a Microsoft Windows 10 Multi-Session Image for Use with App Volumes Features in Horizon Cloud Pods in Microsoft Azure.
    Enable Flash MMR Provides the ability to redirect Flash multimedia content that is streamed to the virtual desktop to stream directly to the client computer and decoded on the client system, to optimize performance. The client system plays the media content, offloading the demand on the virtual desktop.

    This agent option is not supported for use with Microsoft Windows 10 Enterprise multi-session or with Windows 7 Enterprise.

    3D support in RDSH

    3D support in Windows 10 Multi-Session

    Applicable when the OS choice is set to a Windows Server or Windows 10 multi-session operating system. Provides 3D graphics support to applications that run on a GPU-enabled RDSH VM.
    MMR for Terminal Services Provides the ability to redirect multimedia content that is streamed to the virtual desktop to stream directly to the client computer and decoded on the client system, to optimize performance. The client system plays the media content, offloading the demand on the virtual desktop.
    Client Drive Redirection Allows Horizon Client users to share local drives with their virtual desktops and RDS-based applications.
    Skype for Business Provides the ability to use the virtual desktops to make optimized audio and video calls with Skype for Business.
    Webcam Support (Real-Time Audio Video RTAV) Redirects webcam and audio devices that are connected to the users' client systems so that those devices can be used on the virtual desktop.
    Smart Card Not installed by default. Lets users authenticate with smart cards when they use the PCoIP or Blast Extreme display protocol.
    VMware Print Installs and configures the Horizon Agent's VMware Integrated Printing feature in the imported VM. This feature allows users to use any printer available on their client computers, without installing additional drivers.
    Scanner Redirection Not installed by default. Redirects scanning and imaging devices that are connected to the users' client systems so that they can be used on the virtual desktop or RDS-based application.
    USB Redirection Not installed by default. Gives users access to locally connected USB flash drives and hard disks in the virtual desktops and RDS-based applications.
    Note: For guidance on using USB redirection securely, see the Horizon 7 Security guide and the Configuring Remote Desktop Features in Horizon 7 guide. The Horizon version 7.12 of those guides are at security guide and remote desktop features guide. For example, you can use group policy settings to deactivate USB redirection for specific users.
    URL Redirection Not installed by default. Allows Horizon Client to determine which URLs should be handled using the virtual desktop or application instead of using the users' client system, and open those URLs using the virtual desktop or RDS-based application.
    Serial Port Redirection Not installed by default. Redirects devices that are connected to the serial ports on the users' client systems so that they can be used on the virtual desktop or RDS-based application.
    Geolocation Redirection Not installed by default. Allows for sharing the client system's geolocation information with Internet Explorer 11 on the virtual desktop. This option results in the Horizon Geolocation Redirection option installed when the agent is installed in the VM. Additional requirements are needed after the imported VM is ready. For details, see the VMware Horizon documentation topic System Requirements for Geolocation Redirection (Horizon version 7.12).
    Help Desk Provides the ability to collect real-time performance-related, detailed desktop and session metrics from live desktop sessions. Live sessions are sessions that are active, idle, or disconnected. Logged-off sessions are not in this set of live sessions. Those metrics can help you troubleshoot the health of the virtual desktops. Those metrics are used in the console's user card, which is part of the system's help-desk-related features.
    Note: If you turn off this toggle, performance-related metrics from live user sessions in the desktop instances or farm RDSH instances based on this image are not collected. As a result, real-time live user-session data will not be send to the cloud monitoring service (CMS). As a result, such live user-session data cannot be reported in the user card for such sessions or within reports on the Reports page. For details, see About the User Card Feature in Your Horizon Cloud Environment and Reports Page.

    To collect historical session data, in addition to the vRealize Operations Desktop Agent that the Import Virtual Machine wizard installs by default, your Horizon Cloud environment must also have the CMS sessions feature enabled in the General Settings page. If the CMS sessions feature is deactivated, historical session data will not be available to you in the console. To verify the CMS sessions feature's setting in your environment, see the Monitoring table row in Customizable General Settings for Your Horizon Cloud Tenant Environment.

    For extended details about the preceding agent-related options used for VDI desktops and RDS hosts, as well as about all of the Horizon agent features that are always installed by default, see Horizon Agent Custom Setup Options (for those options applicable to a VDI desktop) and Horizon Agent Custom Setup Options for an RDS Host in the VMware Horizon product documentation.
  7. Click Import.
    The system begins creating and configuring the VM. It can take approximately 45 minutes for the overall process to finish at its final point where:
    • For pods of manifest 1600 and later, the VM is listed on the Imported VMs page with powered-on status (green dot) and with an agent status of Not Paired.
    • For pods of manifests prior to 1600, the VM is listed on the Imported VMs page with powered-on status (green dot) an agent status of Active.

    When the VM is initially instantiated in the Microsoft Azure cloud, its name appears on the Imported VMs page. Use the refresh icon to see the latest status of the VM on the page.

    If the VM creation process fails, the system generates a notification about the failure and displays a Failed link in the Agent Version column. Clicking that link opens the Notification page where you can read the reason for the failure.

    Important: When creating an image in Microsoft Azure China cloud, the process can take up to two (2) hours to complete. The process is subject to geographic network issues that can cause slow download speeds as the binaries are downloaded from the cloud control plane.
  8. If the VM is in a pod of manifest 1600 and later, after the automated process is finished and you refresh the page to see the resulting VM with its green powered-on dot and an agent status of Not Paired, use the Reset Agent Pairing action on the VM to pair it with Horizon Cloud.
    Important: Skip this step if you are using a pod of manifest earlier than 1600. In pods that are at versions earlier than this release, the automated wizard results in a VM that is paired with Horizon Cloud with the agent in active state. If you see the resulting VM has an agent status of Active and an agent version number like 19.2, the process is complete.
    If your pod has manifest 1600 and later, after the automated process is finished, the resulting VM is not yet paired with Horizon Cloud. The VM's Agent Status column will display Not Paired (Import Successful), as illustrated in the following screenshot.
    Screenshot of the Imported VMs page listing the VM with Not Paired (Import Successful) displayed in the Agent Status column

    Important: Tech Preview: If you are preparing a VM with Microsoft Windows 10 Enterprise multi-session for use with App Volumes, do not reset the agent pairing at this point. Continue with the steps in Tech Preview - How To Configure a Microsoft Windows 10 Multi-Session Image for Use with App Volumes Features in Horizon Cloud Pods in Microsoft Azure before doing the pairing step.

    Select the VM and then click More > Reset Agent Pairing. The system pairs the VM with the cloud plane. This process can take several minutes to complete. During the pairing process, the VM is restarted and its agent status changes from Not Paired (Import Successful) to Unknown to Active. Use the circular arrow icon to refresh the Imported VMs page to see the VM's current status.

Results

The VM pairing process is completed when the Agent Status column displays Active and an agent version, such as 19.3.0. The following screenshot illustrates a VM after the pairing process is completed.
Screenshot of an imported VM with its Agent Status column displaying Active (19.3.0)

What to do next

Customize the image's Windows operating system, including configuring things like wallpapers and installing the applications you want the VM to provide to your end users. If you enabled a public IP address for the VM, you can connect to the created VM by using the IP address displayed on the Imported VMs page in an RDP client like Microsoft Remote Desktop Connection. For details, see Customize the Imported VM's Windows Operating System.

Note: If your pod is configured to use a proxy, you are responsible for providing a way for the virtual desktop VMs and farm RDSH VMs to be configured with the proxy.

If you selected one of the Microsoft Windows 10 Enterprise multi-session operating systems that includes Office 365, you might need to enable shared computer activation for Office 365 ProPlus so that your end users will be able to use Office 365 applications that are provisioned from the RDS farms based on this VM. For detailed information, see the Microsoft documentation topic Overview of shared computer activation for Office 365 ProPlus.

If you selected Yes for Include GPU, you must log into the VM's operating system and install the supported NVIDIA graphics drivers to get the GPU capabilities of the Microsoft Azure GPU-enabled VM. You install the drivers after the VM is created and the Imported VMs page shows that the agent-related status is active. See Install NVIDIA Graphics Drivers in a GPU-Enabled VM Imported in Horizon Cloud.

If you want to use the features of NSX Cloud and its NSX-T Data Center components with the farm RDSH instances or VDI assignment desktop instances based on this VM, you must log into the VM's operating system and install the NSX agent before publishing the image. See the topics VMware NSX Cloud and Horizon Cloud Pods in Microsoft Azure and Install the NSX Agent in the Horizon Cloud Imported Image VM.

The import process installs the VMware Dynamic Environment Manager client components by default. The FlexEngine client component is installed using its typical mode. The installation path in the resulting VM is C:\Program Files\VMware\Horizon Agents\User Environment Manager. If you want to use VMware Dynamic Environment Manager with the desktop VMs and farm RDSH VMs based on this image, configure a separate file server in your Microsoft Azure subscription that has at least SMB 2 enabled. Then configure VMware Dynamic Environment Manager using that file server. Also configure the GPO settings that are required when the FlexEngine is installed in its typical mode. For details, see the VMware Dynamic Environment Manager documentation topics in the Dynamic Environment Manager product documentation.