Manage hosts (Azure Virtual Desktop)

To manage Azure Virtual Desktop hosts, navigate to Farm > Site > Azure Virtual Desktop and select the Hosts tab.

The list displays hosts from all available host pools. You can apply a filter to the table to see hosts from a particular pool or using other criteria. To apply a filter, click the magnifying glass icon and specify the filter in a column (or columns) of interest.

Tasks that you can perform on a host are accessible from the Tasks menu and include the following:

  • Add: Add a host to one of the available host pools. See the Add a host subsection below.
  • Assign: This option is enabled for hosts from a Personal host pool. It allows you to assign the selected host to a user. If a host is already assigned to another user, you'll be asked if you want to change the assignment. Select an Microsoft Entra ID user when asked. The assignment is done in Azure, so the host status will change to "Assigning" for the duration of the operation.
  • Unassign: Removes the user assignment from the selected host, see Assign above. This menu option is enabled for hosts that are currently assigned to a user. The status of the host changes to "Unassigning" for the duration of the operation.
  • Search: Allows you to search for a host in the list by applying a filter.
  • Show sessions: Switches to the Sessions tab with a filter applied to show the selected host sessions.
  • Show published resources: Displays a list of resources published from the selected host.
  • Show application packages: Displays MSIX application packages added to the selected host.
  • Control: Control options, including enable or disable logons on the selected host, cancel a pending reboot (originated by scheduler), cancel a disabled state (originated by scheduler). See Using scheduler for details.
  • Start, Stop, Reset, Restart: Power operations that can be performed on the selected host. The Restart operation (graceful) has a 10 min timeout. If not completed during this time, the Reset operation (forced) will be used.
  • Upgrade all Agents: Upgrades agents on every host in the list (if necessary).
  • Stop optimization: When an optimization is applied to a host, it can be canceled in the beginning stages. For more information, see Optimization.
  • Tools: Standard RAS tools, including Remote Desktop, computer management, service management, event viewer, Powershell, and others. For the complete description, please see Computer management tools.
  • Troubleshooting: Allows you to check the agent status and update it if necessary. Also allows you to manage logging.
  • Details: Shows details when a host was not created due to a failure. The option opens a dialog describing the reason of failure and some additional information.
  • Change license type: Change the type of Azure license.
  • Recreate: Recreates a host.
  • Delete: Deletes a host from the list and from the host pool to which it belongs. The host (virtual machine) itself is kept or deleted depending on the host pool provisioning type. A host created from a template will be completely removed. A standalone host is not deleted, which means that the virtual machine stays intact.
  • Refresh: Refreshes the list.

Add a host

You can add a host to a host pool from the Hosts tab. To do so:

  1. Click Tasks > Add.
  2. In the Add Hosts dialog, select a target host pool. Depending on the provisioning type configured for the selected host pool, do the following:
    • Standalone: Select one or more hosts from the list. You can also select the option at the bottom to show hosts in other existing host pools on Azure that are not managed by Parallels RAS.
    • Template: Specify the number of hosts to add to the pool from the template.
  3. Click OK.
Was this topic helpful?