Updated on 2025-08-07 GMT+08:00

Assigning Desktops

Scenarios

Assign an idle desktop to a user on the console.

Procedure

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

    The Desktops page is displayed.

  2. Select a desktop whose status is unassigned.

    • Assigning one desktop: Click More > Users > Assign Desktop in the Operation column. On the displayed page, perform 4 to 10.
    • Batch assigning desktops: Select the desktops to be assigned in batches and choose More > Users > Assign Desktop. The page for selecting desktops is displayed. Desktops that cannot be assigned will be automatically filtered out. Check desktops that can be assigned, and click Next: Select User. On the Select User and Assignment Mode page, perform 11 to 19.

      Windows and Linux desktops cannot be selected at the same time.

Assigning one desktop to a user

  1. On the page displayed, select Select User or Create User as required. See Table 1.

    If an existing AD domain is used, you need to create a user on the AD server before assigning desktops.

    • Select User: If a user has been created, you can select the created user for a single-user desktop or select a user or user group for a multi-user desktop, and filter the query result based on the user type, username, user group, and description.
    • Create User: If no user has been created, you can select Create User and configure parameters as instructed in Table 1.
      Table 1 Assigning a desktop to a user

      User Authorization Mode

      Parameter Description

      Operation

      Select User

      You can search for activated users by setting filter criteria.

      You can search for a user based on user type and username.

      Create User > By users for User Activation and Manually for User Import

      • The username is used for user authentication during desktop login.

        Naming rules:

        • A name can contain 1 to 32 characters.
        • A digit-only name is allowed.
        • A name can contain uppercase letters, lowercase letters, digits, periods (.), hyphens (-), and underscores (_), and must start with a lowercase letter or uppercase letter.
        • This field cannot be left blank.
      • The email address is used to receive desktop provisioning emails and related notifications.

        Email address verification rules:

        • Enter a valid email address through system verification.
        • The value can contain a maximum of 64 characters.
      • The mobile number is used to receive desktop provisioning emails and related notifications.
        Mobile number verification rules:
        • [+][Country/Region code][Mobile number]
        • For a mobile number of your country/region, you can omit [+][Country/Region code] and directly enter the mobile number.
        • A mobile number can contain spaces, slashes (/), and hyphens (-).
      1. Configure User Info, Description, and Account Expiration.
      2. Click Add User.
        NOTE:

        Enter an email address or a mobile number, or both.

      Create User > By administrators for User Activation and Manually for User Import

      • The username is used for user authentication during desktop login.

        Naming rules:

        • A name can contain 1 to 32 characters.
        • A digit-only name is allowed.
        • A name can contain uppercase letters, lowercase letters, digits, periods (.), hyphens (-), and underscores (_), and must start with a lowercase letter or uppercase letter.
        • This field cannot be left blank.
      • The initial password is used to authenticate the first login to a desktop. Keep the initial password secure.
        • The password contains 8 to 32 characters.
        • The value can contain uppercase letters, lowercase letters, digits, and special characters !@$%^-_=+[{}]:,./?
        • The password cannot be the username or the reverse username.
          NOTE:

          If your tenant connects to an AD domain, By administrators is unavailable by default.

      Create User > By administrators for User Activation and Batch for User Import

      Upload the user information recorded in the table and create users in batches.

      1. Click Download Template on the right of Import user information to download the user list template.
      2. Enter the serial number, username, email address, mobile number, expiration time, and description in the table as required.
      3. Click Upload to upload the user list that has been filled in as required.
      4. Click OK.
      NOTE:

      The size of the file (only .xlsx and .xls are allowed) to be uploaded cannot exceed 1 MB. A maximum of 200 records can be uploaded at a time.

      Create User > By users for User Activation and Batch for User Import

      Upload the user information recorded in the table and create users in batches.

  2. Click Next. The desktop configuration page is displayed.

    If the original image does not exist or has been deleted, select a public or private image. If there are resource changes, you will be charged the configuration fee and image fee.

  3. Select a naming rule from Desktop Naming Rule, or select Do not use to use the default naming rule.

    To create a naming rule, click Create Desktop Naming Rule. After the creation is complete, click OK. For details, see Desktop Naming Rules.

  4. Select user permissions and set the desktop name. The original desktop name is retained by default. You can also enter a new name.

    • A desktop name can be set only when Desktop Naming Rules is set to Do not use naming rules.
    • A desktop name cannot be set for multi-user desktop assignment. The desktop name remains unchanged.

  5. Click OK.
  6. If you want to perform this operation, enter YES or click Auto Enter.
  7. Click OK.

    Desktop assignment will clear the existing disk data and the data cannot be restored.

Assigning desktops to users in batches
  • A maximum of 100 desktops can be assigned at a time.
  • Only desktops in the running or stopped status can be assigned in batches.
  • Do not perform operations on the desktops during the assignment. You are advised to set the desktops to the maintenance mode to prevent exceptions caused by power supply or other operations performed by users during the assignment.
  • A desktop can be assigned to multiple users, but only one user can use the desktop at a time.
  • The images of the desktops to be assigned in batches must run the same OS, such as Windows or Linux.
  1. Select User or User Group for Select User.
  2. In the user list, you can select target users or user groups by username, user group, description, or enterprise project, and set the permission group.
  3. Set the assignment dimension.

    • By user or user group: You can specify each user or user group and N (0 < N ≤ Number of selected desktops) desktops will be automatically assigned. Ensure that each user or user group is assigned at least one desktop and then consider the number of desktops assigned to each user. Prioritize users or user groups without desktops and sort them by username or user group name in ascending order. Desktops will be matched with users or user groups until all desktops are assigned.
    • By desktop: Multiple users can log in to a desktop. Each desktop is automatically assigned to N (0 < N ≤ 100) users. Desktops are sorted by the number of existing users and then by creation time. The earlier a desktop is created, the higher the priority is. Then, users are sorted by username. Ensure that the use of each desktop has been authorized first, and then consider the number of users authorized to use each desktop.

  4. Set the number of desktops to be assigned or the number of users to whom desktops are to be assigned.

    • When the assignment dimension is by user or user group, set the number of desktops automatically assigned to each user or user group. The value cannot exceed the total number of selected desktops.

      For example, eight desktops (D1 to D8) are assigned to five users or user groups (U1 to U5, among which U1, U2, and U3 do not have desktops). If two desktops are assigned to each user or user group, users or user groups without desktops have a higher priority. In this case, assign the desktops in the following sequence: D1 to U1, D2 to U2, D3 to U3, D4 to U4, D5 to U5, D6 to U1, D7 to U2, and D8 to U3.

    • When the assignment dimension is by desktop, set the number of users or user groups automatically assigned with desktops. The value cannot exceed the total number of selected users.

      For example, five desktops (D1 to D5) are assigned to eight users (U1 to U8) and each desktop is assigned to two users. In this case, each desktop (D1 to D5) is assigned to one user, and then another round of assignment will start from D1 until all users are assigned at least one desktop.

  1. Select a naming rule from Desktop Naming Rule, or select Do not use to use the default naming rule.

    To create a naming rule, click Create Desktop Naming Rule. After the creation is complete, click OK. For details, see Desktop Naming Rules.

  2. Click Preview to view the desktop assignment information.
  3. If the information is correct, confirm the assignment.
  4. If you want to perform this operation, enter YES or click Auto Enter.
  5. Click OK.