Configure USB scanners-Alibaba Cloud Workspace Terminal(Alibaba Cloud Workspace Terminal)-阿里云帮助中心

Obtain peripheral information

For USB peripherals, you need the Vendor Identifier (VID) and Product Identifier (PID) to configure peripheral policies. The VID and PID are hexadecimal strings, such as 0xa12c. The 0x prefix can typically be omitted. You can find the VID and PID of a connected USB peripheral in several ways.

Important

Multiple factors affect the availability of peripherals in a cloud computer. These factors include the type and version of the Alibaba Cloud Workspace terminal and client, the cloud computer image, the local device that runs the client, and the brand and model of the peripheral. You can check the compatibility of a specific peripheral with cloud computers on the Peripheral Compatibility Query page. The data on this page comes from laboratory tests and is for reference only. Actual results may vary.

Workspace terminal

Open and log on to the Alibaba Cloud Workspace client.
In the upper-right corner of the client, click the icon and select Settings.
In the left navigation pane of the Settings window, click Peripherals. In the Local USB Peripherals panel, you can view the VID and PID of your USB peripheral.

Manually on your computer

You can find the VID and PID of a peripheral in your computer's device management information.

Windows

From the Start menu, search for and open Device Manager.
In the Device Manager window, expand and double-click the target USB device.
Go to the Details tab. From the Property drop-down list, select Hardware Ids. The VID and PID are displayed in the Value text box below.

macOS

From the Apple menu bar, choose . In the pop-up window, click More Info.
At the bottom of the About panel, click System Report.
In the left navigation pane of the new window, select Hardware > USB. Select the target USB device on the right to view its VID and PID in the details section below.

Using a third-party tool

You can use the USB Device Tree Viewer tool to view peripheral information. This tool is available for Windows only.

Download the tool from https://www.uwe-sieber.de/usbtreeview_e.html#download.
Unzip the downloaded package and double-click UsbTreeView.exe to run it.
In the navigation tree on the left, select the target USB device. You can find the VID and PID in the Device ID section of the right-side panel.

WUYING hardware terminals

When using a cloud computer with a WUYING hardware terminal, such as a WUYING Cube AS05, WUYING Cube Pro AS06, or WUYING 23.8-inch All-in-One US01, both the administrator and the end user must follow these steps to configure peripheral access.

Administrator: Configure a peripheral policy

Peripheral control policies are part of cloud computer policies, which administrators must create and maintain in the console.

Note

The following procedure uses the Elastic Desktop Service (EDS) console for enterprises as an example. For the specific procedure for the business edition, see Manage policies.

Peripheral policy procedure

Create and bind policy

By default, a new cloud computer is bound to a system-generated default policy that cannot be modified. An administrator must create a custom cloud computer policy and bind it to the cloud computer.

Log on to the Elastic Desktop Service Enterprise console.
In the left navigation pane, choose Operation & Maintenance > Policies.
On the Policies page, click Create Policy.
On the Create Policy page, specify a Policy Name, configure the policy settings as needed, and then click OK.
After the policy is created, you can view it in the list on the Policies page.
In the left navigation pane, choose Resources > Cloud Computers - Enterprise Edition.
On the Cloud Computers - Enterprise Edition page, perform one of the following operations:
- To change the policy for a single cloud computer, find the target cloud computer, click More in the Actions column, and then select Change Policy.
- To change the policy for multiple cloud computers, select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.
In the Change Policy panel, on the Required Policy tab, click Change Policy. Select the new custom policy and click OK.
Note
If a cloud computer belongs to a resource group that already has an associated policy, you cannot change the policy for the cloud computer directly. You must either change the policy associated with the resource group or move the cloud computer out of the resource group before changing its policy.
At the bottom of the Change Policy panel, click OK, and then click Confirm Change.

Modify existing policy

If a cloud computer is already bound to a custom policy, the administrator can modify the policy directly in the console without re-binding it.

Log on to the Elastic Desktop Service Enterprise console.
In the left navigation pane, choose Operation & Maintenance > Policies.
On the Policies page, find the custom policy that you want to modify and click Modify Policy in the Actions column.
On the Modify Policy page, update the policy settings as needed and click OK.

Peripheral policy settings

Enable USB redirection

Method 1: Globally enable USB redirection
- Configuration path: Peripheral Control > Peripheral Redirection > USB Redirection.
- Configuration requirements: Turn on the USB Redirection switch.
Method 2: Enable USB redirection for specific USB devices by using a peripheral whitelist

After you globally enable USB redirection, all USB devices can connect to the cloud computers associated with the policy. If you do not want all USB devices to connect to the cloud computers associated with the policy, you can turn off the USB Redirection switch and enable USB redirection for specific USB devices by adding a peripheral whitelist.
- Configuration path: Peripheral Control > Peripheral Blacklist/Whitelist > Add Rule.
- Configuration requirements: Enter the device name, VID, PID, and set Blacklist/Whitelist to Whitelist.

(Optional) Configure a custom peripheral rule

To prevent end users from configuring incorrectly on the client, administrators can create custom peripheral rules in the cloud computer policy. These rules have higher priority than the custom configurations specified by end users on the client. For information about the priority of peripheral policies in different dimensions, see Policy priority.

Path: Peripheral Control > Peripheral Management Rule > Add Custom Peripheral Rule.
Requirement: Set Device Type to Scanner, enter the device name, VID, and PID, and set Redirect Mode to USB Redirection.

End user: Configure and use the peripheral

Connect the peripheral

You must connect peripherals to the on-premises computer running the Alibaba Cloud Workspace client before you can connect the peripherals to a cloud computer.

When you connect a cloud computer to a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. In the dialog box, you can select the device type, specify whether to turn on auto-connect, and specify whether to remember the current configurations.

Install drivers

After a peripheral is connected successfully, it generally cannot be used directly. You must first install the driver. There are several driver installation methods to choose from.

Automatic scan and install

When you connect a peripheral for the first time, the system automatically scans for a driver. If a matching driver is found in the driver library, the Install Driver dialog box appears. You can then click Install Now.

To use this feature, you must meet the following requirements:

Cloud computer image: The operating system must be Windows, and the image version must be V2.5.0 or later.
WUYING terminal:
- WUYING Cube AS05: Version V7.5 or later.
- WUYING Cube Pro AS06: Version V7.5 or later.
- WUYING Ark NE01: Version V7.5 or later.
- WUYING Ark Pro NS01: Version V7.5 or later.

Install via Cloud Computer Manager

Cloud Computer Manager is a built-in application on your cloud computer that provides comprehensive management features.

Open Cloud Computer Manager in one of the following ways:
- On the cloud computer desktop, double-click the Cloud Computer Manager shortcut icon.
- On the cloud computer desktop, click the floating ball, and then click Cloud Computer Manager.
On the Cloud Computer Manager homepage, click External Device Service.
On the External Device Management page, find the peripheral with the Driver Missing status and click Fix.
- If a driver for the peripheral is found in the WUYING driver library, click Download and Install Driver in the dialog box that appears. After the installation is complete, click Close.
- If a driver for the peripheral is not found in the WUYING driver library but is available on your local device, click Upload and install driver in the dialog box that appears. After the installation is complete, click Close.
- If a driver for the peripheral is not available in the WUYING driver library or on your local device, go to the peripheral manufacturer's official website on the cloud computer to download and install the driver.
If the status of the peripheral changes to Connected, the driver is installed, and the peripheral is ready to use.

Install via WUYING Application Center

You can use it to install drivers and manage applications provided by WUYING or uploaded by your administrator.

Connect to the cloud computer. On the desktop of the cloud computer, double-click the icon to open Wuying App Center.
In the left-side navigation pane of AppCenter, click Driver Wizard.
Note
This feature is available only in WUYING Application Center on Windows cloud computers that use an image of version V2.10.0 or later.
On the WUYING driver library or Enterprise Driver Library tab, search for the peripheral by device type or brand, and then click Download and Install on the device's card.

Manual installation

If none of the above methods work, download and install the driver from the peripheral manufacturer's official website on your cloud computer.

Windows client

When you use a cloud computer with the Windows client, the administrator and the end user must follow these steps to configure peripheral access.

Administrator: Configure a peripheral policy

Peripheral control policies are part of cloud computer policies, which administrators must create and maintain in the console.

Note

The following procedure uses the Elastic Desktop Service (EDS) console for enterprises as an example. For the specific procedure for the business edition, see Manage policies.