Updated on 2026-07-14 GMT+08:00

Managing Desktops

Scenarios

The administrator can start, stop, restart, and delete desktops, and change desktop names. If a user does not need to use a desktop anymore, the administrator can assign the desktop to another user.

Prerequisites

You have purchased a desktop.

Procedure

  1. Log in to the console.
  2. In the navigation pane, choose Desktops > Desktops.

    The Desktops page is displayed.

  3. Perform the operations in Table 1 as required. Some of the operations can be performed on a single desktop or multiple desktops.

    • On a single desktop: Locate the desired desktop, and click Start, Stop, or More > Power Supply > Restart in the Operation column.
    • On multiple desktops: Select the desired desktops in batches and choose operations above the desktop list, such as Start, Stop, or More > Power Supply > Restart.
      Table 1 Operations

      Operation Category

      Operation

      Procedure

      Batch Operation

      Desktop information

      Viewing desktop information

      • View desktop information by selecting search criteria:

        In the search box above the desktop list, select search criteria to view desktop details. Search criteria include desktop ID, desktop name, billing mode, running status, connection status, AZ, subnet, IP address, assigned user, assignment status, image ID, maintenance mode, collaboration status, enterprise project, and resource tag.

        You can search for desktops by desktop ID, desktop name, and assigned user in batches. If you enter multiple filters, separate them with commas (,). For example, you can select Desktop ID and enter ID1,ID2,ID3.

      • View desktop information by filtering columns:
        1. In the upper right corner of the desktop list, click to go to the settings page.
        2. In the basic settings area, determine whether to wrap table content, and fix specified data columns and operation columns.
        3. Customize the columns to be displayed, for example, choose to display the columns indicating the desktop name, monitoring metrics, specifications, image, running status, connection status, disk status, AZ, IP address, Internet or not, assigned user, permission group, creation time, billing mode, remaining duration/total duration, enterprise project, and operation.
        4. Click OK.

      Not supported

      Changing a desktop name

      1. Click next to the desired desktop name.
      2. Enter the new name and click OK.
        NOTE:
        • Only uppercase letters, lowercase letters, digits, and hyphens (-) are allowed.
        • Must start with a letter or digit and cannot end with a hyphen (-).
        • 1 to 15 characters are allowed (each digit or letter represents 1 character).
        • Changing the desktop name will restart the desktop.

      Not supported

      Exporting desktop information

      1. Click Export above the desktop list.
      2. In the displayed dialog box, click Go to Export Center or Download to download the exported desktop information file.

      Supported

      Viewing monitoring metrics

      1. Click in the Monitoring column of a desktop to go to the monitoring metric details page of the desktop.
      2. You can view the following desktop metrics in the last one hour, last 24 hours, last 7 days, last 30 days, or a custom time period.
        • User Online Status: online/offline user count
        • CPU Usage (%): CPU usage of the desktop
        • Memory Usage (%): memory usage of the desktop
        • Disk I/O Read/Write Speed (KB/s): speed at which data is read from or written to the desktop disks in a period of time
        • Disk Read/Write Speed (Requests/s): speed at which data is read from or written to the desktop disks and transferred to other devices
        • Inbound/Outbound Traffic Rate (KB/s): rate at which data flows into or out of the desktop in a period of time

      Not supported

      Viewing failed tasks

      1. In the upper right corner of the desktop management page, click Failed Tasks. The Failed Tasks page is displayed.
      2. You can view the causes of failed tasks, including desktop creation, specification change, disk addition, deletion, and capacity expansion, image creation, system disk rebuilding, desktop assignment, desktop network setting, notification sending, snapshot creation and restoration, user permission change, and desktop hibernation.

      -

      Power supply operations

      Starting a desktop

      1. Click Start to go to the Start Desktop page.
      2. Confirm the operation, and enter YES or click Auto Enter.
      3. Click OK.

      Supported

      Stopping a desktop

      1. Click Stop to go to the Stop Desktop page.
      2. The execution mode is Stop by default.
        NOTE:

        You can select Force if needed.

      3. Confirm the operation, and enter YES or click Auto Enter.
      4. Click OK.

      Supported

      Restarting a desktop

      1. Click More > Power Supply > Restart to go to the Restart Desktop page.
      2. The execution mode is Restart by default.
        NOTE:

        You can select Force if needed.

      3. Confirm the operation, and enter YES or click Auto Enter.
      4. Click OK.

      Supported

      Hibernating a desktop

      1. Click More > Power Supply > Hibernate to go to the Hibernate Desktop page.
      2. Confirm the operation, and enter YES or click Auto Enter.
      3. Click OK.
        NOTE:

        Only Windows desktops can be hibernated.

      Supported

      O&M operations

      Logging in remotely

      1. Click More > O&M > Remote Login.
      2. In the displayed dialog box, click OK to go to the remote login page.
      3. Click Send CtrlAItDel in the upper right corner and enter the username and password to remotely log in to the desktop.
        NOTE:

        Before performing this operation on a new desktop for the first time, ensure that the desktop has been logged in to from the client.

      Not supported

      Rejoining a domain

      1. Click More > O&M > Rejoin Domain to go to the Rejoin Domain page.
      2. Click OK.
        NOTE:
        • This operation can be performed only on running desktops.
        • This operation can be performed only on Windows desktops.
        • This operation can be performed only in the AD scenario.

      Not supported

      Updating the Security Identifier (SID)

      1. Click More > O&M > Update SID to go to the Update SID page.
      2. Click OK.
        NOTE:
        • This operation can be performed only in the AD scenario.
        • An SID uniquely identifies a user, group, or computer account. If the desktop SID is different from the SID of the Windows AD, update the desktop SID to make both SIDs the same. Use this method when desktops are removed from the domain.

      Supported

      Enabling the maintenance mode

      1. Click More > O&M > Enable Maintenance Mode to go to the Enable Maintenance Mode page.
      2. Confirm the operation, and enter YES or click Auto Enter.
      3. Click OK.
        NOTE:
        • In the maintenance mode, all operations, such as user access, self-service maintenance, startup, shutdown, and restart, are not allowed.
        • Desktops that are being connected to and have been connected to will not be affected.

      Supported

      Disabling the maintenance mode

      1. Click More > O&M > Disable Maintenance Mode to go to the Disable Maintenance Mode page.
      2. Confirm the operation, and enter YES or click Auto Enter.
      3. Click OK.
        NOTE:

        This operation can be performed only on desktops in the maintenance mode.

      Supported

      Executing commands

      1. Click More > O&M > Execute Command to go to the Execute Command page.
      2. Click Enter Command to configure the execution.
        1. Execution Environment: Select Windows Script, Windows PowerShell, or Linux Shell.
        2. Set the command execution timeout interval. The value ranges from 1 to 600 minutes.
        3. Enter the commands.
      1. Confirm the operation, and enter YES or click Auto Enter.
      2. Confirm the execution.
        NOTE:
        • When executing commands in batches, you cannot select desktops running Windows and Linux at the same time.
        • This operation can be performed only on running desktops.

      Supported

      Executing a script

      1. Click More > O&M > Execute Script to go to the Execute Script page.
      2. Perform the steps in "Executing a script" in Script Management.

      Supported

      Viewing script records

      1. Click More > O&M > Script Record.
      2. On the Desktop Script Records tab page, view the script records.

      Not supported

      Sending a notification

      1. Click More > O&M > Send Notification to go to the Send Notification page.
      2. Enter the notification message.
      3. Confirm the notification sending.
        NOTE:
        • This operation can be performed only on running desktops.
        • This operation can be performed only on Windows desktops.

      Supported

      Adding a tag

      1. Click More > O&M > Add Tag to go to the Add Tag page.
      2. Enter a tag key and a tag value.
      3. Click OK. For details, see Managing Tags.

      Supported

      Playing a screen recording

      1. Click More > O&M > Screen Recording Playback to go to the Screen Recording Records page.
      2. You can view screen recording records by All time, Last 7 days, Last 30 days, Last 180 days, or in a custom time range.

      Not supported

      User management

      Changing user permissions

      1. Click More > Users > Change User Permission to go to the Change User Permission page.
      2. Select a permission group as required:
        1. Administrator permission group: Users in this group have system administrator permissions, that is, full permissions on a computer. They can perform all management tasks, including managing all users, on the computer.
        2. User permission group: Users in this group have basic operation permissions on a computer, for example, running applications, but cannot modify the OS settings or data of other users.
      3. Click OK.
        NOTE:

        After changing the user permission, you need to restart or log out of the desktop for the change to take effect.

      Supported

      Unbinding a user

      For details, see Unbinding Users.

      Supported

      Assigning a desktop to a user

      For details, see Assigning Desktops.

      Supported

      Enabling collaboration

      For details, see Collaborative Desktops.

      Supported

      Disabling collaboration

      For details, see Collaborative Desktops.

      Supported

      Desktop management

      Using desktop tags

      Manage desktops by tag and filter them by tag on the GUI.

      • Desktops without tags: View them in the All desktops area.
      • Desktops grouped by tag: Select Desktop Tags in the search box on the left, and select Key and Value to filter desired desktops.

      Supported

      Add tags to or remove them from desktops.

      Adding a tag to desktops. The following is an example of how to add Tag2 to desktops with Tag1.

      1. Under tag management, select the tag key and value, and select the tags to be added.
      2. Click Add. The Add Tag to Desktop dialog box is displayed.
      3. Filter desktops by desktop name or tag key, and select the desktops to which you want to add tags.
      4. Confirm the operation, and enter YES or click Auto Enter.
      5. Click OK.

      Removing a tag from desktops. The following is an example of how to remove Tag2 from desktops and add Tag1 to the desktops.

      1. Under tag management, select the tag key and value, and select the tags to be removed.
      2. Click Remove. The Remove Tag from Desktop dialog box is displayed.
      3. Confirm the removal of the tag from desktops and select the tag to be added to desktops.
      4. Confirm the operation, and enter YES or click Auto Enter.
      5. Click OK.
      NOTE:

      If there are any protocol policies or scheduled tasks using this tag, they will become invalid after the tag is removed.