Parallels RAS 20 Administrator's Guide
ProductsSupportPartnersDocumentation
English
English
  • Parallels RAS 20 Administrator’s Guide
    • Introduction
      • Parallels RAS release history
      • About Parallels RAS
      • About this guide
      • What's new
      • Terms and abbreviations used in this guide
    • Installing Parallels RAS
      • System requirements
        • Hardware requirements
        • Software requirements
        • Microsoft license requirements
      • Install Parallels RAS
      • Log in and activate Parallels RAS
    • Getting Started with Parallels RAS
      • The Parallels RAS Console
      • Set up a basic Parallels RAS Farm
        • Add an RD Session Host
        • Publish applications
        • Invite users
        • Azure Virtual Desktop
        • Conclusion
    • Farm and Sites
      • Connecting to a Parallels RAS Farm
      • About Sites
      • Sites in the RAS Console
      • Adding a Site to the Farm
      • Replicating Site settings
      • Managing Licensing Site
      • Managing administrator accounts
        • Adding an administrator account
        • Administrator account permissions
        • Managing administrator accounts
        • Configure RAS Console idle sessions
        • Using instant messaging
        • Joining Customer Experience Program
    • RAS Connection Broker
      • Configuring RAS Connection Brokers
      • Secondary Connection Brokers
      • Managing Secondary Connection Brokers
      • Using computer management tools
    • RAS Secure Gateway
      • Overview
      • Adding a RAS Secure Gateway
      • Manually adding a RAS Secure Gateway
      • Checking the RAS Secure Gateway status
      • Configuring a RAS Secure Gateway
        • Enable or disable a Secure Gateway
        • Set public address
        • Set IP addresses for client connections
        • Site defaults (Secure Gateways)
        • Gateway mode and forwarding settings
        • Gateway network options
        • SSL/TLS encryption
          • SSL server configuration
        • Configure User Portal
          • Using Site defaults
          • Enable or disable User Portal
          • Client settings
          • Network load balancers access
        • Wyse ThinOS support
        • Secure Gateway security
        • Web request load balancing
      • Secure Gateway tunneling policies
      • Configure logging
      • Viewing Secure Gateway summary and metrics
      • Using computer management tools
    • RD Session Hosts
      • RD Session Host types
      • Add an RD Session Host
        • Installing the agent manually
      • Add a template-based RD Session Host
      • Manage RD Session Hosts
        • Manage host pools (RD Session Hosts)
          • Add host pools (RD Session Hosts)
          • Upgrading Agents (RD Session Hosts)
        • Manage templates (RD Session Hosts)
          • Creating an RD Session Host template
          • Assigning a template to a host pool (RD Session Host)
          • Managing RD Session Hosts based on a template
        • Manage hosts (RD Session Hosts)
          • Viewing RD Session Hosts
          • Check an RD Session Host Agent status
          • Change RD Session Host Site assignment
          • View and modify RD Session Host properties
            • Using default settings
            • General
            • Agent settings
            • User profile
            • Application Packages
            • Optimization
            • Desktop access
            • RDP printer
          • User profile
            • User Profile Disks
            • FSLogix
              • Configure managing existing profiles by Parallels RAS
              • FSLogix antivirus exclusions
          • Optimization
          • Drive redirection cache
          • Configure logging
        • Manage sessions (RD Session Host)
        • Using scheduler (RD Session Hosts)
      • Planning for high availability
      • Managing logons
      • Using computer management tools
      • Publishing from an RD Session Host
      • Viewing published resources
    • Virtual Desktop Infrastructure (VDI)
      • Supported providers
      • Add a provider
        • RAS Provider Agent information
          • RAS Provider Agent installation options
        • Add a hypervisor provider
        • Add a cloud Provider
          • Microsoft Azure
            • Introduction and prerequisites
            • Create Microsoft Entra ID application
            • Add Microsoft Azure as a Provider
            • Microsoft Azure and templates
          • Amazon Web Services
            • Introduction and prerequisites
            • Design considerations
            • Step 1. Creating an IAM user for programmatic access
            • Step 2. Adding AWS as a Provider
      • Manage VDI
        • Manage providers (VDI)
          • Installing RAS Provider Agent using the installer
          • Checking the RAS Provider Agent status
          • Using a Provider in multiple farms
        • Manage host pools (VDI)
          • Add host pools (VDI)
          • Delete host pools (VDI)
          • Add and delete host pool members
          • Using a wildcard to filter VMs
          • Managing hosts in pools
          • Upgrading Agents (VDI)
        • Manage templates (VDI)
          • Virtual desktop templates
          • Multi-provider template distribution
          • Creating a VM template
            • Step 1: Check and install the Agent
            • Step 2: Configure the template
              • Properties
              • Distribution
              • Advanced
              • Preparation
              • Optimization
              • License keys
              • Summary
              • Host naming
            • Parallels Test Template Wizard
            • Modifying template properties
          • How hosts are created from a template
          • Manually adding a host
          • Assigning a template to a host pool (VDI)
          • Template maintenance
          • Template status
          • Managing multi-provider template distribution
          • Managing template-based hosts
        • Manage hosts (VDI)
          • Persistent hosts
          • Configuring hosts to interact with RAS Provider Agent in a different subnet
        • Manage sessions (VDI)
        • Using scheduler (VDI)
      • Configure logging
      • Enabling high availability for VDI
      • Site defaults (VDI)
      • Using computer management tools
      • Viewing Provider summary
      • Remote PC pools in VDI
        • Adding a Provider
        • Adding Remote PCs to a Provider
        • Adding Remote PCs to a pool
        • Managing Remote PCs in a pool
        • Persistent Remote PCs
        • RAS Guest Agent installation options
    • Azure Virtual Desktop
      • Introduction
      • Prerequisites
      • Deploy Azure Virtual Desktop
        • Enable Azure Virtual Desktop and add a provider
        • Add workspaces
        • Add host pools (Azure Virtual Desktop)
      • Manage Azure Virtual Desktop
        • Manage providers (Azure Virtual Desktop)
        • Manage workspaces (Azure Virtual Desktop)
        • Manage host pools (Azure Virtual Desktop)
          • Upgrading Agents (Azure Virtual Desktop)
        • Manage templates (Azure Virtual Desktop)
          • Create a template
          • Manage existing templates
          • Assigning a template to a host pool (Azure Virtual Desktop)
        • Manage hosts (Azure Virtual Desktop)
        • Manage sessions (Azure Virtual Desktop)
        • Using scheduler (Azure Virtual Desktop)
      • Site defaults (Azure Virtual Desktop)
        • Site defaults for single-session hosts
        • Site defaults for multi-session hosts
      • Using Parallels Client with Azure Virtual Desktop
      • Verify the deployment
    • Remote PCs
      • Overview
      • Manage host pools (Remote PC)
      • Manage hosts (Remote PC)
        • Adding a Remote PC to a Farm
          • Admin-initiated Remote PC enrollment
          • Self-service Remote PC enrollment
        • Configuring a Remote PC
      • Viewing Remote PC summary
      • Using computer management tools
    • Publishing
      • Overview
      • Publishing a desktop
      • Publishing an application
      • Publishing local applications
      • Publishing an application with MSIX app attach
      • Publishing a web application
      • Publishing a network folder
      • Publishing a document
      • General management tasks
      • Manage published applications
      • Manage published desktops
      • Manage published documents
      • Manage folders
      • Site defaults (Publishing)
      • Using filtering rules
      • Configuring preferred routing
      • Understanding session prelaunch
      • Checking effective access
      • Specifying client settings
      • Quick keypad
    • Session Management
      • Overview
      • Session information
      • Monitoring settings
      • Managing sessions
      • The Resources tab
    • SSL Certificate Management
      • Generating a self-signed certificate
      • Generating a certificate signing request (CSR)
      • Let's Encrypt certificates
        • Requesting a Let's Encrypt Certificate
        • How Parallels RAS requests certificates from Let's Encrypt
      • Importing a certificate
      • Exporting a certificate
      • Assigning a certificate to Secure Gateways and HALBs
      • Auditing certificates
      • Permissions to manage certificates
      • Upgrading from an older RAS version
    • Connection and Authentication Settings
      • RAS Connection Broker connection settings
      • Remote session settings
      • Logon hours settings
      • Restricting access by Parallels Client type and build number
      • Multi-factor authentication
        • Adding an MFA provider
        • Using RADIUS
          • Connection
          • Attributes
          • Automation
          • Advanced
          • Configuring Azure MFA
          • Configuring Duo
        • Using TOTP
          • Configuring TOTP
          • Configuring Google Authenticator
          • Configuring Microsoft Authenticator
        • Configuring email OTP
        • Using Deepnet DualShield
          • Supported tokens
          • Configuring DualShield 5.6+ Authentication Platform
          • Configuring Parallels RAS to use the DualShield Authentication Platform
          • Connect to a RAS Farm
        • Using SafeNet
          • Configuring SafeNet
        • Configuring MFA rules
      • Allowing users to change domain password
      • Allowing users to discover RAS connections via email address
    • Load Balancing and HALB
      • Resource based & round robin load balancing
        • Configure CPU optimization
      • High availability load balancing (HALB)
        • Prerequisites
        • Deploying a Parallels HALB appliance
        • Adding a HALB virtual server
        • HALB Device status and version number
        • HALB maintenance
        • HALB connection and session information
        • Changing the HALB appliance password
    • RAS Multi-Tenant Architecture
      • Overview
      • Architecture description
        • Implementation overview
        • User connection flow
      • Deploying Tenant Broker and Tenants
        • Deploying Tenant Broker
        • Deploying a Tenant
          • Join a Tenant to Tenant Broker
          • Joining with a secret key
          • Verify join status
          • Configure network
          • Assign a public domain address
          • Configure an SSL certificate
          • Set up routing for incoming traffic
        • User authentication
        • Unjoining from Tenant Broker
      • Managing Tenants
        • Tenant configuration
        • Deleting a Tenant object
        • Opening a Tenant console
      • Shared Gateways
      • Third-party network load balancers
      • Web Client and Themes
      • Monitoring Tenants
      • Tenant Broker compatibility and updates
      • Upgrading from an older RAS version
      • Configuring notifications
      • Communication ports
    • SAML SSO Authentication
      • Introduction
      • System requirements
      • SAML basics
      • SAML configuration
        • Prerequisites
        • IdP side configuration
        • SP side configuration (RAS side)
        • Active Directory user account configuration
        • Configure certificate authority templates
          • Create an Enrollment Agent template
          • Create a smartcard logon certificate template
        • RAS Enrollment Server configuration
        • RAS Enrollment Server high availability
        • SAML integration examples and tips
          • User account attributes
          • Security tip
      • Parallels Client configuration
      • Parallels client policy configuration
      • Test the SAML SSO deployment
      • Error messages
    • Parallels Web Client and User Portal
      • Configure Web Client
      • Configure Themes
        • General settings
        • Access settings
        • Message settings
        • Web Client settings
          • URLs
          • Branding
          • Colors
          • Language bar
          • Messages
          • Input prompt
          • Gateway
          • Legal policies
        • Parallels Client for Windows settings
        • General Theme tasks
        • Delegating session management permissions
      • Open Parallels Web Client
      • Main menu options
      • Running remote applications and desktops
        • Using drag and drop functionality
        • Native clipboard experience
        • Other useful features
      • Auto login
      • Direct App access
      • Using the toolbar
        • Using the toolbar on desktop computers
        • Using the Toolbar on Mobile Devices
        • Using the remote clipboard
        • Hiding toolbar items
    • Universal Printing
      • Managing Universal Printing Settings
      • Universal Printing drivers
      • Font management
    • Universal Scanning
      • Managing Universal Scanning
      • Adding scanning applications
    • User Device Management and Client Policies
      • Inviting users to connect to Parallels RAS
      • Mass configuring user devices
      • Enabling Help Desk support for users
      • Enabling Help Desk support for custom administrators
      • Monitoring devices
        • Getting additional device information
      • Windows device groups
      • Managing Widows devices
        • Windows desktop replacement
      • Scheduling Windows devices & groups power cycles
      • Client policies
        • Add a new client policy
        • Configure session settings
          • Appearance
          • Connection
          • Display
          • Printing
          • Scanning
          • Audio
          • Keyboard
          • Local devices and resources
          • Experience
          • Network
          • Server authentication
          • Advanced settings
        • Configure client policy options
        • Configure control settings
        • Configure Gateway redirection
        • Client policy backward compatibility
        • Policy information in Parallels Client
      • Configuring remote file transfer
        • Configure file transfer to a server
        • Configure file transfer in User Portal
        • Configure file transfer for a client policy
    • Reporting
      • System requirements
      • Install Microsoft SQL Server
        • Install Microsoft SQL Server 2016 or earlier
        • Install Microsoft SQL Server 2017 or 2019
        • Install Microsoft SQL Server 2022
      • Install Parallels RAS Reporting
      • Running Parallels RAS Reports
      • GDPR compliance
    • Performance monitor
      • Overview
      • Install RAS Performance Monitor
      • Using Parallels RAS Performance Monitor
      • Configure RAS Performance Monitor security
      • Updating RAS Performance Monitor
    • Common Management Tasks
      • Recovery – add a root administrator
      • Host name resolution
      • Computer management tools
      • Site information
      • Site settings
      • Using MSIX application packages
      • Using template versions
      • Settings audit
      • Upgrading RAS agents
      • Licensing
      • Configure HTTP proxy settings
      • System event notifications
        • Configuring notification handlers
        • Configuring notification scripts
        • Configuring SMTP server connection for event notifications
      • RAS session variables
      • Resolving z-order issues
      • Maintenance and backup
        • Importing and exporting Farm settings from the command line
      • Problem reporting and troubleshooting
      • Logging
      • Suggest a feature
    • Parallels RAS Management Portal
      • Overview
      • Prerequisites
      • Installation
      • Log in to RAS Management Portal
      • Configure RAS Web Administration Service
      • RAS Management Portal user interface
    • Parallels RAS APIs
      • RAS PowerShell API
      • RAS REST API
        • Installation
        • Permissions
        • Getting started
        • Logging in and sending requests
        • More information
      • RAS Web Client API and Parallels Client URL scheme
    • Appendix
      • Microsoft license requirements in Parallels RAS
      • Port reference
        • Parallels Client
        • Web browsers
        • HALB
        • RAS Secure Gateway
        • RAS Connection Broker
        • RAS Console
        • SSRS
        • RAS Reporting
        • RAS Web Administration Service (REST/Management Portal)
        • RAS PowerShell
        • RAS Provider Agent
        • RAS Enrollment Server
        • RAS RD Session Host Agent
        • RAS Guest Agent
        • RAS Remote PC Agent
        • Tenant Broker
        • Active Directory and Domain Services ports
        • Azure Virtual Desktop
      • RAS performance counters
Powered by GitBook

© 2025 Parallels International GmbH. All rights reserved.

On this page
  • Host pool properties
  • General
  • Configuration
  • Autoscale
  • Hosts
  • Installing agents
  • Repairing agents
  • Adding hosts to a pool
  • Application packages
  • Assignment
  • User profile
  • Optimization
  • Settings
  • RDP printer
  • Agent auto-upgrade
  • AVD agent

Was this helpful?

Export as PDF
  1. Parallels RAS 20 Administrator’s Guide
  2. Azure Virtual Desktop
  3. Manage Azure Virtual Desktop

Manage host pools (Azure Virtual Desktop)

A host pool is a collection of one or more identical virtual machines (VMs) within an Azure Virtual Desktop environment. Each host pool contains an application group that users can access.

Host pools can be configured a number of different ways depending on the intended purpose. The following table describes different options that you can choose when creating a host pool.

Option
Description

Personal vs. pooled

  • Personal host pools contain single session hosts, each of which is assigned to a single user. The assignment is persisted even after the user logs off or the host is powered off. You can unassign the host from a user and assign it to a different user if needed.

  • Pooled host pools contain multi-user session hosts (RD Session Hosts or multi-session Window 10 machines), which are not assigned to any particular user. Each host in a pool can serve multiple users (multi-session).

Application vs. desktop

A host pool can only publish applications or desktops, but not both at the same time. When you create a host pool, you choose a publishing type from Desktop or Application. An application group of the appropriate type (Desktop or RemoteApp) for the host pool is created automatically. Note that you cannot change the publishing type later. If you decide that you want to change it, you'll have to delete the existing host pool and create a new one.

Template vs. standalone

When you create a host pool, you need to select from Template or Standalone. A host pool can contain hosts that already exist (Standalone) or it can use a template which in turn could be based on an existing guest VM or chosen to be created on the fly from images in Azure Marketplace or in your Shared Image Gallery.

  • Template: Hosts can be created from the template by the administrator manually or they can be created automatically when there's a demand. Automatic host creation (called Autoscale in Parallels RAS) can be turned on or off in the host pool properties.

  • Standalone: Hosts are added and removed to/from a host pool by the administrator. Hosts (virtual machines) must already exist in Azure and must be domain joined.

To manage Azure Virtual Desktop host pools, navigate to Farm > Site > Azure Virtual Desktop and select the Host pools tab.

Host pool properties

To view and modify host pool properties, right-click it and choose Properties. In the dialog that opens, select tabs and view or modify host pool properties as described below.

General

On the General tab, you can enable or disable the host pool. Note that if you disable it, all hosts and published resources will also be disabled.

You can also modify the host pool description and view general host pool properties.

In the Application group section, you will see the name of the application groups created for the host pool.

The Friendly name field shows the friendly name used for the workspace in Azure Virtual Desktop and Parallels RAS.

Configuration

On the Configuration tab, examine the host pool configuration properties. You should be familiar with them from when you created a host pool.

You can modify the following properties on this page:

  • Load balancer

  • Limit number of sessions on host

  • Power on host on-demand

  • Validation environment

Autoscale

The Specifications section allows you to overwrite the virtual machine size specified in the settings of the template used by the given host pool. Select the Overwrite the size specified in template properties option and select a desired size from the drop-down list. The selected size will only be used by this host pool. Other host pools using the same template will be unaffected. Note that available sizes may depend on the location, size, and power state of the host pool members and the template. Also note that overwriting the size requires a host reboot.

Hosts

The Hosts tab lists hosts from this host pool. You can examine the status of a host and other properties by looking at the values in the table.

The Status column should indicate "OK" if a host is operating normally. To verify the agent status, right-click a host and choose Check agent.

Installing agents

If you see a message Agent did not reply, click Install to try and install the agent. If everything goes well, the agent will be updated and the Status column should say OK. You can also upgrade all agents by clicking Tasks > Upgrade all Agents.

Repairing agents

If you see Broken (Host unavailable) in the Status column, the Azure Virtual Desktop agent has become unresponsive.

To repair the agent:

  • Click Tasks > Repair.

This will uninstall the Azure Virtual Desktop agents, remove the host from the host pool, reinstall the Azure Virtual Desktop agents and add them to the host pool. During this process the Status column will show the status Deployment in progress.

Adding hosts to a pool

To add a new host to the pool:

  1. Click Tasks > Add.

  2. Depending on the host pool provisioning type, do one of the following:

    • If the host pool provisioning is configured as Standalone, select one or more hosts from the list. You can also select the Show hosts in existing host pools not managed by RAS option to show hosts that exist in other host pools on Azure.

  3. Click OK.

Application packages

Assignment

The Assignment tab displays Active Directory users and groups assigned to Microsoft Entra ID objects. In order for users to see published desktops and applications, they must be assigned to the application group available in the host pool.

To create a new assignment:

  1. Click Tasks > Add.

  2. In the Select User or Group dialog, specify a user or group and click OK.

  3. Follow the onscreen instructions and complete the assignment. Note that additional filtering in the Publishing category may be used to control Azure Virtual Desktop resource availability in Parallels Client. For details, see Publish resources.

User profile

Optimization

Settings

RDP printer

Agent auto-upgrade

AVD agent

The AVD agent tab allows you to schedule updates for Azure Virtual Desktop agents installed on the hosts in the host pool. If you do not schedule the updates, they will be installed automatically when Microsoft releases a new version.

Note: Microsoft recommends always installing the latest stable version of the agent so that hosts do not lose connectivity or be subjected to security vulnerabilities.

To schedule AVD agent updates:

  1. Go to the Farm > Site > Azure Virtual Desktop > Host pools > Properties > AVD agent tab.

  2. Select the Scheduled Microsoft AVD agent updates option.

  3. Select the time zone for the updates:

    • If you want to use the host's local time zone, select the Use local session host time zone option.

    • If you want to use a specific time zone, select it in the Time zone drop-down menu.

  4. Specify the date and time for the maintenance window.

Note: If, after four attempts, the agent fails to update all hosts in the host pool, the update will happen the next time the hosts are turned on.

  1. (Optional) You might want to create two maintenance windows to ensure that updates are installed during the designated time. To do that, select the Add an additional window option and specify the date and time for the second maintenance window.

PreviousManage workspaces (Azure Virtual Desktop)NextUpgrading Agents (Azure Virtual Desktop)

Last updated 4 months ago

Was this helpful?

For the explanation of configuration properties, see .

This tab is shown only for host pools with Template as a provisioning type. Here you can select a template if one has not been specified for the host pool yet. You can also create a new template by clicking the Create new button, which will open a wizard. If you don't have any templates, the only selection available is None, which means that there's no template to create hosts from. If that's the case, you need to create a template first and then select it here. See also .

The Autoscale settings section contains settings that determine how hosts (virtual machines) are created from the specified template. These settings work the same as Autoscale settings for RD Session Host groups. The only difference is, in Azure Virtual Desktop we deal with hosts and host pools, while in RD Session Host groups we talk about servers and groups, otherwise the settings work in a similar manner. For details, please see the Autoscale subsection in .

If the host pool provisioning is configured as Template, you cannot manually add hosts here. Instead, use the tab in the main Azure Virtual Desktop view.

See Using .

By default, this tab inherits its settings from Site defaults. If you wish to specify custom settings, clear the Inherit default settings option. For the information about configuring user profile, please see .

The Optimization tab allows you to specify settings that will be used to optimize session hosts for best performance in a Parallels RAS environment. You can select Windows components, services, and other options that will be disabled, removed, or optimized to ensure a more efficient, streamlined, and improved delivery of virtual apps and desktops. By default, this tab inherits its settings from Site defaults. If you wish to specify custom settings, clear the Inherit default settings option. For the information about configuring optimization options, please see .

This tab allows you to configure settings such as sessions timeouts, client URL/Mail redirection, drag and drop and others. By default, this tab inherits its settings from Site defaults. If you wish to specify custom settings, clear the Inherit default settings option. For the information about configuring host pool settings, please see .

The RDP Printer tab allows you to configure the renaming format of redirected printers. By default, this tab inherits its settings from Site defaults. If you wish to specify custom settings, clear the Inherit default settings option. For the information about configuring user profile, please see .

See .

For more information about Azure Virtual Desktop agents, see .

Add an Azure Virtual Desktop host pool
Manage templates
Grouping and cloning RD Session Hosts
Hosts
MSIX application packages
Site defaults (Azure Virtual Desktop)
Site defaults (Azure Virtual Desktop)
Site defaults (Azure Virtual Desktop)
Site defaults (Azure Virtual Desktop)
Upgrading Agents (Azure Virtual Desktop)
https://learn.microsoft.com/en-us/azure/virtual-desktop/whats-new-agent