Share via

Assign a device

  • Article

You can assign a device to a different device group in the catalog or unassign a device from an existing device group. The unassigned device moved to the default location (.default) in your catalog.

Note

You must have Azure Sphere Contributor permissions to the catalog to be able assign a device or unassign device. The option is disabled if you do not have the required permissions.

Use the portal

  1. Sign in to the Azure Portal. To locate the Azure Sphere service, in the top search bar, enter and select Azure Sphere. The Azure Sphere page is displayed.
  2. Go to the Devices page to list all available devices.
  3. Select the device you want to assign.
  4. Select Assign from the menu at the top of the page to assign a device to another device group or
  5. Enter the following information:
    1. Product: [Required] From the drop-down menu, select the product which contains the device group to which you want to move the device.
    2. Device group: [Required] From the drop-down menu, select the device group to which you want to move the device.
  6. Select Assign.

Use the CLI

Use the az sphere device assign command to assign a device into a different device group.

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

Tip

We recommend that you configure the default values for the subscription, resource group, and catalog parameters. This helps reduce redundancy and can significantly shorten CLI command syntax.

Unless you have set the active subscription, the --subscription parameter will be required for all commands. You can set the active subscription using the command az account set --subscription <subscription-name>.