Help Center> Workspace> User Guide (Administrators)> Desktops> Managing Desktops
Updated on 2024-07-19 GMT+08:00
View PDF

Managing Desktops

Scenario

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 Workspace console.
  2. In the navigation pane, choose Desktops > Desktops.

    The Desktops page is displayed.

  3. Perform the operations in Table 1 as required.

    Table 1 Operations

    Operation

    Procedure

    Checking desktop information
    • Check desktop information by property type.
      • Click in the search box above the desktop list.
      • Filter data based on the property type and check desktop information by desktop ID, desktop name, billing mode, running status, login status, subnet, IP address, desktop user, assignment status, image ID, maintenance mode, collaboration status, and enterprise project.
    • Check desktop information by filtering columns.
      • Click above the desktop list.
      • Check desktop information by condition such as monitoring, running status, login status, Internet access, desktop user, permission group, billing mode, and enterprise project.

    Changing a desktop name
    1. Click next to a desktop name.
    2. Enter the new name and click OK.
      NOTE:
      • Only letters, digits, and hyphens (-) are allowed. The name must start with a letter or digit and cannot end with a hyphen, and can contain a maximum of 15 characters.
      • After the desktop name is changed, the desktop will be restarted.

    Exporting a desktop list

    Click above the desktop list to export the list of all desktops of the current project. You can check desktop information, such as desktop creation time, in the downloaded file.

    Deleting a desktop

    For pay-per-use desktops:

    1. Select a desktop and click More > Delete above the desktop list or in the Operation column.
    2. On the page displayed, select Confirm.
      NOTE:

      You can also select Delete users at the same time.

    3. Click OK.

    For yearly/monthly-billed desktops:

    1. Select a desktop and click More > Unsubscribe above the desktop list or in the Operation column.
    2. On the desktop unsubscription page, confirm the desktop information and click OK.
    3. On the Unsubscribe from Resource page, confirm the unsubscription and select or write the reason for unsubscription, select the resource and data statement for desktop unsubscription, and click Confirm.

      For details about resource unsubscription, see Unsubscriptions.

    Stopping a desktop
    1. Select a desktop and click Stop in the upper left corner of the page or in the Operation column.
    2. On the page displayed, select Confirm.
      NOTE:

      You can also select Forcibly Stop.

    3. Click OK.

    Starting a desktop
    1. Select a desktop and click Start in the upper left corner of the page or in the Operation column.
    2. On the page displayed, select Confirm.
    3. Click OK.

    Hibernating a desktop
    1. Select a desktop and choose More > Hibernate above the desktop list or in the Operation column.
    2. On the page displayed, select Confirm.
    3. Click OK.
      NOTE:

      Currently, only Windows desktops can be hibernated.

    Restarting a desktop
    1. Select a desktop and click Restart in the upper left corner of the page, or choose More > Restart in the Operation column.
    2. On the page displayed, select Confirm.
      NOTE:

      You can also select Forcibly Restart.

    3. Click OK.

    Remotely logging in to a desktop
    1. Select a desktop and choose More > Log In Remotely in the Operation column.
    2. In the displayed dialog box, click OK.
    3. Click Send CtrlAItDel in the upper right corner and enter the username and password to remotely log in to the desktop.
      NOTE:

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

    Creating a snapshot
    • Creating a snapshot for one desktop:
      1. Select the desired desktop and choose More > Create Snapshot above the desktop list, or More > Create Snapshot in the Operation column.
      2. On the page displayed, specify Applied To. Then enter System Disk Snapshot Name or Data Disk Snapshot Name, or both, as well as System Disk Snapshot Description or Data Disk Snapshot Description, or both.
      3. Click OK.
    • Batch creating snapshots for desktops:
      1. Select the desired desktops and choose More > Create Snapshot above the list.
      2. On the page displayed, specify Applied To. Then enter System Disk Snapshot Name or Data Disk Snapshot Name, or both, as well as System Disk Snapshot Description or Data Disk Snapshot Description, or both.
      3. Click OK.
    NOTE:

    A maximum of 10 snapshot creation records can be retained for each desktop, including snapshot creation records on the console and by end users.

    Restoring a snapshot
    1. Click on the left of the desired desktop, and click the Snapshots tab.
    2. Restore a snapshot.
      • Restoring one snapshot:

        Click Restore in the Operation column.

        On the page displayed, select I understand the impact of this operation. Shut down the VM and restore the snapshot. and click OK.

      • Batch restoring snapshots:

        Batch select the desired snapshots and click Restore above the snapshot list.

        On the page displayed, select I understand the impact of this operation. Shut down the VM and restore the snapshot. and click OK.

    NOTE:
    • Only the snapshots of one data disk and one system disk can be restored for a desktop at a time.
    • The desktop will be forcibly shut down during snapshot restoration.
    • A time point will be specified for snapshot restoration. After the restoration, data generated after this time point cannot be retrieved.

    Deleting a snapshot
    1. Click on the left of the desired desktop, and click the Snapshots tab.
    2. Delete a snapshot.
      • Deleting one snapshot:

        Click Delete in the Operation column.

        On the page displayed, select I understand the impact of the operation and confirm to delete the snapshot. and click OK.

      • Batch deleting snapshots:

        Batch select the desired snapshots and click Delete above the list.

        On the page displayed, select I understand the impact of the operation and confirm to delete the snapshot. and click OK.

    NOTE:

    Recomposing the system disk, deleting a desktop, or deleting a disk will automatically delete the snapshot of the desktop.

    Sending a notification
    1. Select a desktop and choose More > Send Notification above the desktop list, or More > Send Notification in the Operation column. The Send Notification page is displayed.
    2. Enter the content of the message to be sent and click Send.
      NOTE:
      • Notifications can be sent only for desktops that are running.
      • This operation can be performed only on Windows desktops.

    Add a desktop to the domain again
    1. Select the desired desktop and choose More > Set and Change > Add Desktop to Domain Again in the Operation column.
    2. On the page displayed, click OK.
      NOTE:
      • This operation can be performed only on desktops that are running.
      • This operation can be performed only on Windows desktops.
      • This operation can be performed only in the AD scenario.

    Updating the Security Identifier (SID)
    1. Select the desired desktop and choose More > Update SID above the list, or More > Set and Change > Update SID in the Operation column.
    2. On the page displayed, click OK.
      NOTE:
      • SIDs can be updated only in the AD scenario.
      • A Security Identifier (SID) is an ID that 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.

    Managing desktop scripts
    1. Select a desktop and choose More > Script > Execute Script in the Operation column. For a batch operation, select the desired desktops and choose More > Execute Script above the desktop list. For details, see Script Management.
    2. Select a desktop and choose More > Script > Execute Command in the Operation column, and click Enter Command. On the displayed page, select Execution Environment, specify Command Timeout, and enter a command. Then click Execute. You can also check Command Records.
    3. Select a desktop and choose More > Script > Script Record in the Operation column to check script execution records on the Scripts page.

    Enabling the maintenance mode
    1. Select the desired desktop and choose More > Enable Maintenance Mode above the desktop list, or More > Enable Maintenance Mode in the Operation column. To batch enable the maintenance mode for desktops, select the desired desktops and choose More > Enable Maintenance Mode above the desktop list.
    2. Select Confirm and 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.

    Disabling the maintenance mode
    1. Select the desired desktop and choose More > Disable Maintenance Mode above the desktop list, or More > Disable Maintenance Mode in the Operation column. To batch disable the maintenance mode for desktops, select the desired desktops and choose More > Disable Maintenance Mode above the desktop list.
    2. Select Confirm and click OK.

Parent topic: Desktops