Overview of Azure Sphere CLI

The Azure Sphere CLI is a set of commands used to manage your Azure Sphere resources.

The following commands are available:

• ca-certificate
• device
• device-group
• feedback
• get-support-data
• hardware-definition
• image
• image-package
• interactive (Command is in preview)
• login
• logout
• product
• role
• show-user
• show-version
• setting
• tenant

Azure Sphere CLI and Azure Sphere classic CLI

The Azure Sphere CLI is installed alongside the existing CLI on both Windows and Linux, so you have access to either interface. The Azure Sphere classic CLI continues to work as it always has.

To use the Azure Sphere CLI:

• On Windows, use PowerShell or a standard Windows Command Prompt.
• On Linux, use any command shell. Specify the azsphere command if you set Azure Sphere CLI as the default during SDK installation, or the azsphere_v2 command if you set the Azure Sphere classic CLI as the default.

See Azure Sphere CLI for details about the features and commands supported by Azure Sphere CLI.

Command-line format

The azsphere command line has the following format:

azsphere [command] [subcommand] operation [parameters]

In general, command and subcommand are nouns and operation is a verb, so that the combination identifies both an action and the object of the action. Most commands and operations have both a full name and an abbreviation. For example, the device command is abbreviated d.

Most parameters have both a long name and an abbreviation. On the command line, introduce the long name with two hyphens and the abbreviation with a single hyphen. For example, the following two commands are equivalent:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

Some commands allow multiple values for a single parameter. In Azure Sphere CLI you can supply a single parameter followed by a list of values separated by spaces and in the Azure Sphere classic CLI the list of values are separated by commas. For example:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

azsphere image-package pack-application --input myDirectory --output myImagePackage --executables filepath-1,filepath-2

Quotation marks and escapes characters

When you work with Azure Sphere CLI commands, be aware of how your shell uses quotation marks and escapes characters. If you support scripts used in different shells, you need to understand how they differ.

For example:

• Bash: Quoting
• PowerShell: About Quoting Rules
• Windows Command Prompt: How-to: Escape Characters, Delimiters, and Quotes at the Windows command line

Cloud-dependent commands

The following azsphere commands require a cloud connection and login to the Azure Sphere Security Service:

• ca-certificate
• device-group
• get-support-data
• image
• login
• logout
• product
• role
• show-user
• tenant

In addition, the following azsphere device commands also require a cloud connection:

Device capability-dependent commands

The following azsphere device commands require a device capability be used for devices in manufacturing state DeviceComplete:

If you attempt to run these commands without a capability, you receive an error message telling you to either run azsphere device enable-development or use azsphere device capability to download and select a capability file for the device.