After you create an assignment that uses resources from one or more of your pods in Microsoft Azure, you can manage the assignment using the Horizon Universal Console. The types of assignments in your Horizon Cloud tenant environment depend on what you have created.

Tip: The console is dynamic and reflects the workflows and settings that are appropriate for the up-to-the-moment situation in your Horizon Cloud tenant environment. The labels displayed for the console's assignment-related pages will vary depending on factors such as the tenant's configured brokering setting, the types of cloud-connected pods in your fleet, the tenant's regional cloud plane, and features that are based on specific licensing.

You work with assignments from the console's assignments-related pages. The types of actions you can use on an assignment depends on the assignment's type and whether you can use that action on that type. As an example, the Update Agent action applies only to dedicated VDI desktop assignments, while the Delete action can be used on all assignment types. For information about creating assignments, see the respective instructions. Usually, but not always, the console will hide an action from view if that action is not applicable to the listed assignments.

The following table provides links to the steps for creating various assignment types.

Assignment Type Instructions
VDI desktop
Session-based desktop Create an RDSH-Session-Based Desktop Assignment
App Volumes application assignment Horizon Cloud - Create an App Volumes Assignment
Remote application Remote Applications - Create a Remote Application Assignment for Remote Applications Provisioned By Horizon Cloud Pods in Microsoft Azure
URL redirection customization See Single-Pod Broker - Horizon Cloud Pods - Create a URL Redirection Customization and Assign it to Users .
Note: When your tenant environment is configured to use Universal Broker Universal Broker for your pods in Microsoft Azure, use of URL redirection customizations is not currently supported.

After locating the assignment you want to work with listed on one of the pages within the console's Assignments area, you can invoke an action on that assignment by selecting its corresponding check box and clicking the appropriate displayed action. Some buttons are accessed under the More or actions.

Remember: Because the console is dynamic and reflects the workflows that are appropriate for a particular use case and the up-to-the-moment situation in your tenant environment, the action buttons displayed on a console page will vary depending on whether an action is appropriate for the page on which the assignment is listed. As a result, some of the buttons listed below might not be displayed on a particular assignment-related page, or if displayed, might not be actionable for a specific listed assignment.
Edit
Clicking this button launches a wizard in which you can change the editable settings in the assignment. The launched wizard is similar to the creation wizard for that assignment type, with read-only fields for those settings that cannot be changed. For detailed descriptions of the fields, see the creation topics at the above documentation links.

For some assignment types, instead of using the Edit button, you can click an assignment's name and update the settings from the assignment's summary page.

Duplicate
You can use this action to duplicate the selected desktop assignment and create a new one with the same specifications but a new name. The wizard that opens is the same as the creation wizard for the same desktop assignment type as the one you are duplicating.
Take Offline
This action applies to floating VDI desktop assignments, dedicated VDI desktop assignments, and URL redirection customization assignments. Clicking this button opens a window in which you can select to take the assignment offline.

The system behavior when you take an assignment offline depends on the selected assignment type.

  • For an active URL redirection customization assignment, you use Take Offline to turn off the URL redirection behavior defined in the assignment.
  • For VDI desktop assignments, you use Take Offline to take the assignments off line to perform maintenance actions that would impact incoming connection requests. When you click Take Offline for a VDI desktop assignment, the system puts the assignment into offline mode and prevents users from logging in to the assignment's desktops.
    Note: Image update does not start in an offline assignment. Even though you can edit the offline assignment to have it use an updated image, the system does not start the update operation until you bring the assignment back online.
Update Agent
On the Assignments page, this action applies only to dedicated VDI desktop assignments. See Update Agent Software for Dedicated VDI Desktop Assignments.
Bring Online
Clicking this button opens a window in which you can select to bring an offline assignment back online.
Delete, Remove
The console can display this action using one of these two labels. You use this button to delete the selected assignment. Delete an Assignment from Your Horizon Cloud Environment.

Actions You Can Perform Within a VDI Desktop Assignment's Detailed Pages

For VDI desktop assignments, you can perform actions specific to those assignment types from within the assignment's detailed pages. To see these detailed pages, locate the assignment within the console's assignment-related pages and click its name. Initially the Summary page is displayed.

Summary page
The Summary page displays the VDI desktop assignment's current settings. If the console provides for editing values from this page, you can click the edit-related icon to change those settings that the system allows to be updated for an existing VDI desktop assignment. Some settings cannot be changed on a VDI desktop assignment after it is created, such as its pod.
Desktops page
The Desktops page displays the existing desktop VMs in the VDI desktop assignment. As a result of the console's dynamic nature, the actions that are displayed and available to click will depend on the desktop VM's current state and whether the assignment is a floating VDI desktop assignment or a dedicated VDI desktop assignment. As an example, even though the Reset Agent Pairing action is provided for desktops in a dedicated VDI desktop assignment, it is not provided for desktops in a floating VDI desktop assignment.
  • For a desktop in floating VDI desktop assignments, you can restart it, power it off (if the desktop is powered on), and log off or disconnect the currently connected user (if any).
    Note: Do not manually delete a desktop in a floating VDI desktop assignment, because the system's power management feature will automatically creates a new desktop VM to take the place of the deleted one. To adjust the number of desktops in a floating VDI desktop assignment, see Resizing a VDI Desktop Assignment in Your Horizon Cloud Environment.
  • For a desktop in dedicated VDI desktop assignments, you can restart it, power it on or off (depending on the desktop's current state), log off or disconnect the currently connected user (if any), assign the desktop to a specific user (if the desktop is unassigned), unassign the desktop (if the desktop is assigned to a user), and reset the agent pairing for cases where the desktop is powered on but the agent status is not showing as active. Unassigning the desktop removes the mapping of the desktop to that user and makes it available to be mapped to a different user. Resetting the agent pairing repairs the desktop VM's pairing state with Horizon Cloud. When agent update has failed for a desktop, there is a visual indicator in the Status column. When this occurs, you can use the Roll Back option to return the desktop to the previous agent software version. Placing your pointer on the warning icon displays the time period within which you must perform the rollback.
    Note: Do not manually power on a desktop, even if the action is available in the Desktops page. Manually powering on a desktop might conflict with the power management settings that are set in the dedicated VDI desktop assignment. If you manually power on a desktop, unexpected results of other desktops powering off might occur. Instead of powering on a desktop, use the Restart action.
System Activity page
The System Activity page displays activity in the desktop assignment due to system actions, such as powering off desktops to meet the power management schedule. On the System Activity page, you can cancel tasks and export reports.
  • You can cancel some tasks before they complete by selecting the task in the list and clicking Cancel Tasks.
    • Before attempting to select a task for cancellation, refresh the view to update the status for the tasks displayed.
    • If a task is currently in a state where the system allows you to cancel it, you can select the check box corresponding to that cancellable task.
    The table below shows tasks that you can cancel.
    Task Cancel When Task is in Queued State Cancel When Task is in Running State
    Farm Expansion Supported
    Note: When the system has automatically created an expansion task for an RDSH farm, the farm must be offline before you can cancel that task.
    Supported
    Note the following:
    • When the system has automatically created an expansion task for an RDSH farm, the farm must be offline before you can cancel that task.
    • Resources that have already been created, such as VMs and OS/data disks, are destroyed when the task is canceled. When VMs are destroyed or not created, this changes the size of the assignment.
    • This option is not available for multi-cloud assignments.
    Assignment Expansion Supported
    Note: When the system has automatically created an expansion task for a VDI desktop assignment and assignment creation or update is in progress, tasks can be cancelled. After assignment creation/updation is finished, no tasks can be cancelled.
    Supported
    Note the following:
    • When the system has automatically created an expansion task for an RDSH farm, the farm must be offline before you can cancel that task.
    • Resources that have already been created, such as VMs and OS/data disks, are destroyed when the task is canceled. When VMs are destroyed or not created, this changes the size of the assignment.
    • This option is not available for multi-cloud assignments.
    Convert VM to Image Supported
    Note: If you cancel this task, and wish to retry it, first confirm that the VM is in a state where it can be converted. If you are not sure, power off and then power on the VM.
    Supported
    Note: If you cancel this task, and wish to retry it, first confirm that the VM is in a state where it can be converted. If you are not sure, power off and then power on the VM.
  • You can export the displayed information as a report file with the Export Report feature.

    When you export a report, it appears on the Exported Reports tab of the Reports page, where you can download the report. See Reports Page for more information.

    When you begin the export, you can choose whether you want to export all data or only the data as currently filtered. Then a message appears at the top of the page indicating that the report is being generated. You can see the progress of the report and download it when complete on the Exported Reports tab of the Reports page. Depending on the number of records, the preparation time can take several minutes. For example, a report with 50,000 records takes approximately 10 minutes.

    Attention: If any of your pods in Microsoft Azure are at manifests earlier than 2552, the process for larger reports is as follows:
    • When you begin the export a message appears stating that the report is being compiled and it can take some time. Depending on the number of records, the preparation time can take several minutes. For example, a report with 50,000 records takes approximately 10 minutes.
    • When the preparation is done, another dialog box appears with the message Report Generated Successfully and a Download button. After clicking the Download button, you must wait for the download to complete before closing this dialog box. Closing it before the download is complete cancels the download.

    Because you cannot perform any other actions in the console until this process is finished, if you have a large number of activity records you should plan to export the information when you can wait up to 10 minutes before performing other tasks in the console.

User Activity page
The User Activity page displays activity in the VDI desktop assignment due to user actions, such as logging on and logging off sessions provided by the assignment.

You can export the displayed information as a report file with the Export Report feature.

When you export a report, it appears on the Exported Reports tab of the Reports page, where you can download the report. See Reports Page for more information.

When you begin the export, you can choose whether you want to export all data or only the data as currently filtered. Then a message appears at the top of the page indicating that the report is being generated. You can see the progress of the report and download it when complete on the Exported Reports tab of the Reports page. Depending on the number of records, the preparation time can take several minutes. For example, a report with 50,000 records takes approximately 10 minutes.

Attention: If any of your pods in Microsoft Azure are at manifests earlier than 2552, the process for larger reports is as follows:
  • When you begin the export a message appears stating that the report is being compiled and it can take some time. Depending on the number of records, the preparation time can take several minutes. For example, a report with 50,000 records takes approximately 10 minutes.
  • When the preparation is done, another dialog box appears with the message Report Generated Successfully and a Download button. After clicking the Download button, you must wait for the download to complete before closing this dialog box. Closing it before the download is complete cancels the download.

Because you cannot perform any other actions in the console until this process is finished, if you have a large number of activity records you should plan to export the information when you can wait up to 10 minutes before performing other tasks in the console.