Overzicht van de Azure Sphere-extensie voor Azure CLI

Het opdrachtregelprogramma voor het beheren van gekoppelde Azure Sphere-apparaten en cloudimplementaties wordt gedistribueerd als een Azure CLI-extensie.

De Azure CLI en de Azure Sphere-extensie installeren

De Azure Sphere-extensie voor Azure CLI verkrijgen:

1. Installeer de Azure CLI als u dit nog niet hebt gedaan.

2. Voer de volgende opdracht uit om de Azure Sphere-extensie toe te voegen:

   az extension add --name azure-sphere
   

U moet zich aanmelden met Azure CLI om u aan te melden bij het Azure-abonnement dat u wilt gebruiken om Azure Sphere-apparaten te beheren.

Zodra een extensie is geïnstalleerd, wordt de locatie ervan gevonden onder de waarde van de $AZURE_EXTENSION_DIR shell-variabele. Als deze variabele niet is ingesteld, is de standaardwaarde in Linux en MacOS $HOME/.azure/cliextensions en in Windows %USERPROFILE%\.azure\cliextensions.

Tip

Nadat u zich hebt aangemeld, ziet u een lijst met abonnementen die zijn gekoppeld aan uw Azure-account. Zorg ervoor dat u het abonnement selecteert met de vereiste machtigingen met behulp van de az account set opdracht voor de Azure Sphere-extensie om correct te functioneren. Zie Meerdere Azure-abonnementen gebruiken voor meer informatie over het selecteren van abonnementen.

De Azure Sphere-extensie beheren

Gebruik de opdracht om de geïnstalleerde versies van Azure CLI-extensies te bekijken:

az version

Als u de Azure Sphere-extensie wilt bijwerken naar de nieuwste versie, gebruikt u:

az extension update --name azure-sphere

Als u de Azure Sphere-extensie wilt verwijderen, gebruikt u:

az extension remove --name azure-sphere

Algemene Azure Sphere CLI-opdrachten

U kunt Azure Sphere-opdrachten gebruiken door te typen az sphere vanuit de Windows-opdrachtprompt of PowerShell. In Linux kunt u elke opdrachtregelinterface (CLI) gebruiken. De CLI heeft volledige tabvoltooiing voor opdrachten in de bash-shell.

Deze tabel bevat enkele algemene Azure Sphere-opdrachten en koppelingen naar hun referentiedocumentatie.

Opdracht	Beschrijving
az sphere catalog	Beheer uw catalogus.
az sphere ca-certificate	Certificaten in uw catalogus beheren.
az sphere deployment	Implementaties in uw catalogus beheren.
az sphere device	Azure Sphere-apparaten beheren.
az sphere device-group	Apparaatgroepen in uw catalogus beheren.
az sphere image	Afbeeldingen in uw catalogus beheren.
az sphere product	Producten in uw catalogus beheren.
az sphere get-support-data	Verzamel diagnostische gegevens over uw systeem-, cloud- en apparaatconfiguraties.

Met Azure CLI kunt u configuratieopties instellen die het gebruik van Azure Sphere CLI-opdrachten vereenvoudigen door standaardinstellingen op te geven voor parameters zoals de --resource-group, --subscriptionof --catalog.

Apparaatafhankelijke opdrachten

De opdracht werkt met een lokaal gekoppeld Azure Sphere-apparaat. Als u de opdracht probeert uit te voeren zonder een apparaat dat is gekoppeld, krijgt u een foutmelding. Zie az sphere device voor meer informatie over apparaatopdrachten

• az sphere device claim
• az sphere device recover
• az sphere device restart
• az sphere device show-attached
• az sphere device show-os-version
• az sphere device app show-memory-status
• az sphere device app show-quota
• az sphere device app show-status
• az sphere device app start
• az sphere device app stop
• az sphere device capability show-attached
• az sphere device capability update
• az sphere device certificate add
• az sphere device certificate delete
• az sphere device certificate list
• az sphere device certificate show
• az sphere device certificate show-quota
• az sphere device image list-installed
• az sphere image-package show
• az sphere device manufacturing-state show
• az sphere device manufacturing-state update
• az sphere device network proxy apply
• az sphere device network proxy delete
• az sphere device network proxy show
• az sphere device network disable
• az sphere device network enable
• az sphere device network list-firewall-rules
• az sphere device network list-interfaces
• az sphere device network show-diagnostics
• az sphere device network show-status
• az sphere device network update-interface
• az sphere device sideload delete
• az sphere device sideload deploy
• az sphere device wifi add
• az sphere device wifi disable
• az sphere device wifi enable
• az sphere device wifi forget
• az sphere device wifi list
• az sphere device wifi reload-config
• az sphere device wifi scan
• az sphere device wifi show
• az sphere device wifi show-status

Algemeen beschikbare argumenten

De volgende globale parameters zijn beschikbaar voor de Azure Sphere-extensie:

Parameter	Description
--debug	Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
--help -h	Toont het Help-bericht.
--only-show-errors	Er worden alleen fouten weergegeven, waarschuwingen onderdrukken.
--output -o	Uitvoerindeling. Toegestane waarden: json, jsonc, none, table, , tsv, yaml. yamlc Standaard: json.
--query	JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
--subscription	: naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
--verbose	Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor de volledige logboeken voor foutopsporing.