Troubleshoot Azure Sphere CLI

Important

This is the Azure Sphere (Legacy) documentation. Azure Sphere (Legacy) is retiring on 27 September 2027, and users must migrate to Azure Sphere (Integrated) by this time. Use the Version selector located above the TOC to view the Azure Sphere (Integrated) documentation.

Here are some troubleshooting steps for problems that may occur when running commands in the Azure Sphere CLI:

Unicode characters are not supported

Product and device group names can contain only alphabetic characters (A-Z) and numeric characters (0-9). Unicode characters are no longer supported and an error is reported when you run a command containing unicode character in the parameter values.

We recommend that you update any existing device group and product names to remove unicode characters.

For example, use the product ID to rename the product Product-MyFridge:

azsphere product update --product 6f52bead-700d-4289-bdc2-2f11f774270e --new-name MyFridgeProduct

For example, use the device group ID to rename the device group DeviceGroup-Marketing:

azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-name Marketing

Troubleshoot script running on Windows Command Prompt

You can run a script containing a series of commands on PowerShell, Linux command shell, or a standard Windows Command Prompt. However, in a standard Windows Command Prompt the script is terminated after the first command is run. To resolve this, you must add call or cmd /c in front of each command. For example:

Use the following format to use call:

call azsphere show-version
call azsphere tenant show-selected
call azsphere show-user

Use the following format to use cmd /c:

cmd /c azsphere show-version
cmd /c azsphere tenant show-selected
cmd /c azsphere show-user

Asynchronous operations

Some operations in Azure Sphere can take time to reflect the changes even if the command returns success. We recommend waiting for a few seconds for the changes to take effect.