Updated on 2026-11-18 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:

        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, 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. Set the columns to be displayed, including the desktop name, monitoring metrics, specifications, image, running status, connection status, disk status, AZ, IP address, Internet or not, assigned user, permission group, VPC name/ID, subnet name/ID, security 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 a new desktop name.
        NOTE:
        • Enter 1 to 15 characters.
        • Enter only letters, digits, and hyphens (-).
        • Start with a letter or digit and do not end with a hyphen (-).
        • Changing the desktop name will restart the desktop and delete unsaved data. Exercise caution when performing this operation.
      3. Enter YES or click Auto Enter to confirm the operation.
      4. Click OK.

      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

      Metric

      Viewing monitoring metrics: Administrators can view desktop real-time monitoring metrics about processes, CPUs, memory, handles, networks, and applications.

      NOTE:
      • Supported OS: Windows desktops only.
      • Supported AccessAgent version: 26.9.0 or later.
      • Constraints:
        • After the AccessAgent version is upgraded, you need to reconnect the desktop.
        • Only running desktops can report monitoring data. The metrics cannot be updated when desktops are stopped, faulty, or deleted.

      In the desktop list, click the icon in the Monitoring Metric column. On the monitoring details page, you can view the following information:

      NOTE:

      Click View More to go to the Cloud Eye console and view details about resource instance metrics. Workspace has some unique metrics (such as process information, peripheral list, software installation list, and process killing capability), while Cloud Eye supports only some basic monitoring metrics (such as CPU and disk). Therefore, the monitoring metrics on the two pages are different.

      • Basic information: includes the computer name, desktop ID, specifications, disk, IP address, and EIP.
      • Desktop usage: Allows you to view the total desktop usage duration, continuous idle duration, and user online status over the last 1 hour, 24 hours, 7 days, 30 days, or a custom period (30 days) within the last 180 days.
      • System metrics:
        • Includes the total numbers of processes, threads, and handles on the desktop.
        • Displays the following metrics in the last one hour, last 6 hours, last 1 day, last 3 days, or last 7 days:
          • CPU usage (%): Displays the CPU usage trend, along with details about the top 10 processes (including the process name, process ID, and CPU usage).
          • Memory usage (MB): Displays the memory usage trend, along with details about the top 10 processes (including the process name, process ID, and memory usage).
          • Disk I/O (KB/s): Displays the trends for disk read speed, write speed, and active time, along with details about the top 10 processes (including the process name, process ID, read speed, and write speed).
          • Number of handles: Displays the handle count trend, along with details about the top 10 processes (including the process name, process ID, and number of handles).
          • Network (Kbps): Displays the trends for network sending and receiving speeds, along with details about the top 10 processes (including the process name, process ID, sending speed, and receiving speed).
          • GPU memory: Displays the GPU memory usage trend, along with details about the top 10 processes (including the process name, process ID, and GPU memory usage).
      • System resources:
        • Applications: Click to search and view application details (including name, version, publisher, and installation time) by service name, application version, or publisher.
        • Services: Click to search and view service details (including name, description, status, and startup type) by service name, status, or startup type.
        • Drivers: Click to search and view driver details (including name, description, vendor, version, and status) by driver name, vendor, version, or status.
        • Peripheral devices: Click to search and view peripheral details (including device name, vendor ID, product ID, and driver) by device name, vendor ID, product ID, or driver.

      Not supported

      Stopping processes: Administrators can view real-time monitoring data and stop applications or processes based on service requirements.

      1. Click next to System Metrics to go to the Real-time Process Monitoring page.
      2. Select a refresh interval from the drop-down list, for example, 10s, 20s, 30s, 60s, or 120s.
      3. Filter real-time metric information by attributes, including the name, process ID, CPU, memory, disk I/O, network, status, session ID, user, and command.
      4. In the Operation column, click End Application or Terminate Process to stop a specified application or forcibly terminate a specified system process.

      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.
        • GPU desktops are not supported.

      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

      Adding a single desktop to a domain again:

      1. Choose More > O&M > Rejoin Domain to go to the Rejoin Domain page.
      2. Click OK.

      Adding desktops to a domain again in batches:

      1. Select the desired desktops and choose More > O&M > Rejoin Domain in the upper part. The Rejoin Domain page is displayed.
      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.

      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 a custom time range.

      Not supported

      Upgrading a version

      Perform the steps in Upgrading the Desktop Version.

      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

      Desktop management

      Using desktop tags

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

      • All desktops: Click All desktops under Desktop tags to view all desktops.
      • Untagged desktops: Click Untagged Desktop under Desktop tags to view all untagged desktops.
      • 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. Enter YES or click Auto Enter to confirm the operation.
      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. Enter YES or click Auto Enter to confirm the operation.
      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.