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
  • Parallels RAS 20.2
  • Parallels RAS 20.1
  • Parallels RAS 20
  • Parallels RAS 19.4.2
  • Parallels RAS 19.4.1
  • Parallels RAS 19.4
  • Parallels RAS 19.3.1
  • Parallels RAS 19.3
  • Parallels RAS 19.2.3
  • Parallels RAS 19.2.2
  • Parallels RAS 19.2
  • Parallels RAS 19.1
  • Parallels RAS 19.0

Was this helpful?

Export as PDF
  1. Parallels RAS 20 Administrator’s Guide
  2. Introduction

What's new

PreviousAbout this guideNextTerms and abbreviations used in this guide

Last updated 2 months ago

Was this helpful?

Parallels RAS 20.2

The following new features were added in Parallels RAS 20.2:

Deprecations and updated system requirements:

  • See for updated system requirements for components and clients.

Parallels RAS 20.1

The following new features were added in Parallels RAS 20.1:

  • Support for Nutanix AOS 6.10

Parallels RAS 20

The following new features were added in Parallels RAS 20:

  • Added support for SC//HyperCore 9.4

  • Added support for the Swiss and Belgian keyboard layouts in the policies

Parallels RAS 19.4.2

The following new features were added in Parallels RAS 19.4.2:

Parallels RAS 19.4.1

The following new features were added in Parallels RAS 19.4.1:

Parallels RAS 19.4

The following new features were added in Parallels RAS 19.4:

  • Support for IGEL 11 and 12.

  • Extended image management for Nutanix AHV (AOS).

  • Support for Scale Computing SC//HyperCore 9.2.

  • Validation of HTTP host headers to protect against host header injections.

    • Sessions disconnections for host pools

    • Transport protocol for host pools

    • Bandwidth availability for host pools

    • Latency for host pool

    • Connection quality for host pool

    • UX Evaluator for host pool

    • Logon duration for host pool

  • Azure Virtual Desktop improvements.

Parallels RAS 19.3.1

Important: Do not update to Parallels RAS 19.3 if you assigned multiple templates to a single VDI host pool.

Important: If you are using Azure Virtual Desktop in Parallels RAS 19.3, you need to update Parallels Client to version 19.3.

The following new features were added in Parallels RAS 19.3.1:

  • Azure Virtual Desktop improvements.

Parallels RAS 19.3

Important: Do not update to Parallels RAS 19.3 if you assigned multiple templates to a single VDI host pool.

Important: If you are using Azure Virtual Desktop in Parallels RAS 19.3, you need to update Parallels Client to version 19.3.

The following new features were added in Parallels RAS 19.3:

  • Template versioning for RD Session Hosts, VDI, and Azure Virtual Desktop. This feature includes the following:

  • Ability to configure user profiles and other settings on the host pool level.

  • Dynamic printer mapping.

  • Azure Virtual Desktop improvements.

  • Add multiple provider addresses for the SC//HyperCore provider.

  • Ability to hide billing information on Tenants.

  • Ability to recreate hosts keeping the existing MAC addresses on the SC//HyperCore provider.

  • TLS 1.3 support.

  • Terminology updates:

    • References to Pools/Groups have been standardized as "Host Pools".

    • Reference to Desktop/Guests have been standardized as "Hosts".

    • Session activity

    • Disconnection reasons

Parallels RAS 19.2.3

The following new features were added in Parallels RAS 19.2.f3:

Parallels RAS 19.2.2

The following new features were added in Parallels RAS 19.2.2:

Parallels RAS 19.2

The following new features were added in Parallels RAS 19.2:

  • Ability to recreate RD Session Hosts and hosts with their original BIOS UUID on ESXi and vCenter (works automatically).

Deprecations and updated system requirements:

Parallels RAS 19.1

The following new features were added in Parallels RAS 19.1:

    • Transport protocol (TCP/UDP)

    • Network latency

    • Connection quality

    • Bandwidth availability

Deprecations and updated system requirements:

Parallels RAS 19.0

The following new features were added in Parallels RAS 19.0:

  • New Parallels Client for Windows for ARM64.

Deprecations and updated system requirements:

AWS Availability Zones support for and host pools

.

.

Ability to select whether unenrolled users can see the The user name or password is incorrect error when they enter incorrect credentials for , , and .

.

Ability to automatically upgrade Agents on , , and .

.

Ability to edit the message that will be shown by Parallels Client when users sign in using MFA for and .

.

.

.

:

For the complete list of new features and improvements, see Release notes: .

The ability to assign template versions to host pools for , , and .

Scheduled template recreation for R, , and .

.

.

.

.

.

:

For the complete list of new features and improvements, see Release notes: .

.

.

For the complete list of new features and improvements, see Release notes: .

A. You can also .

For the complete list of new features and improvements, see Release notes: .

.

Disk storage cost optimization for and .

Ability to choose the transport protocol for connections between Parallels Client and a server on , , and .

Ability to use RDP Shortpath for and AVD hosts.

.

New policy for selecting the display configuration

.

See for updated system requirements for components and clients.

For the complete list of new features and improvements, see Release notes: .

.

.

.

.

.

.

.

.

:

See for updated system requirements for components and clients.

For the complete list of new features and improvements, see Release notes: .

.

.

.

Expression-based , filtering for and configuration.

Power management: starting up and shutting down servers on schedule. Schedules can be created for , , and .

.

.

.

.

.

See for updated system requirements for components and clients.

For the complete list of new features and improvements, see Release notes: .

Ability to choose several datastores during host pool creation
Ability to change Z-Order for published applications
Ability to repair an AVD deployment
Ability to schedule Agent updates for AVD
Ability to use more than five automations for RADIUS MFA
Ability to change account group for group users
Ability to add custom root certificates
Software Requirements
Ability to use the available area for an application on a single monitor
Ability to launch applications from local devices
RDSH
VDI
Ability to redirect local disk drives as read-only.
Ability to limit clipboard to plain text.
Ability to use SAML SSO together with credentials for user authentication
Ability to add a custom background for User Portal
TOTP
Google Authenticator
email OTP
Ability to automatically connect to an alternative Connection Broker
Ability to select if Parallels Client detection is triggered on sign-in to User Portal or after the user confirms it via a prompt
Ability to configure a Service URL through which User Portal will detect the IP of the browser it is running on
Added an option to map the Windows key to a key combination when running User Portal on Chrome OS
Ability to send OTP via email.
RD Session Hosts
VDI
Azure Virtual Desktop
Ability to enable tunneling for the <Default> Theme
Radius
TOTP
Active Directory (AD) based permissions for session management.
Ability to add a customizable URL that points to internal support from RAS Console and Management Portal
Administrator permissions to view license information
Ability to configure the minimum key size of certificate authority templates
New predefined reports
Ability to automatically reset sessions on user logoff.
https://kb.parallels.com/en/129018
Version management
RD Session Hosts
VDI
Azure Virtual Desktop
D Session Hosts
VDI
Azure Virtual Desktop
Ability to change user passwords via third-party IdPs
New policy for configuring drive redirection cache
New policy for prohibiting saving username
Ability to drain and power off hosts based on the workload.
FSLogix Office Containers support and enhanced management for FSLogix
FIPS 140-2 compliance
New predefined reports
https://kb.parallels.com/en/129018
Ability to turn off audit database synchronization across Connection Brokers
Support for drive redirection cache in a session initiated by Parallels Client for macOS
https://kb.parallels.com/en/129018
bility to modify the license type of a host when it joins a host pool
manually change the license type of any host within a host pool
Ability to lock or log off from a computer when all user sessions are closed.
https://kb.parallels.com/en/129018
Integration with MSIX app attach for AVD
VDI
AVD
RDSH
VDI
Remote PC
single-session
multi-session
Ability to connect to AVD resources using Parallels Web Client
.
Ability to assign persistent hosts by the client device hostname
Added Microsoft Authenticator as a TOTP provider.
Software Requirements
https://kb.parallels.com/en/129018
Integration with MSIX app attach for VDI
Search for client policies
Ability to update all agents in an AVD host pool simultaneously
New policy for configuring dynamic desktop resizing for published applications
New policy for configuring multimedia redirection on Azure Virtual Desktop
Ability to register public domain addresses when using a secret key for joining a RAS Tenant Broker
Ability to supply public domain addresses when joining a tenant to a RAS Tenant Broker using a secret key
Ability to easily view the details of a failure to create a hosts
New predefined reports
Software Requirements
https://kb.parallels.com/en/129018
Support for Amazon Web Services as a cloud provider and ability to use EC2 instances
Integration with MSIX app attach
Let's Encrypt certificate management
client policies
published resources
MFA
RD Session Hosts
VDI
AVD hosts
Email-based account discovery that gives users quick access to the RAS resources when using the Parallels Client
Logon hours restrictions that allow to restrict user access to published resources during specified time frames
Ability to assign different MFA providers to different Themes
Ability to specify URLs to be redirected to local end user device or to be launched in the remote session
Ability to delegate to Custom administrators permissions for working with specific publishing folders
Software Requirements
https://kb.parallels.com/en/129018
Version tags