Übersicht über die Azure Sphere-Erweiterung für Azure CLI
Das Befehlszeilentool zum Verwalten von angefügten Azure Sphere-Geräten und Cloudbereitstellungen wird als Azure CLI-Erweiterung verteilt.
Installieren der Azure CLI und der Azure Sphere-Erweiterung
So erwerben Sie die Azure Sphere-Erweiterung für Azure CLI:
Installieren Sie die Azure CLI , wenn Sie dies noch nicht getan haben.
Führen Sie den folgenden Befehl aus, um die Azure Sphere-Erweiterung hinzuzufügen:
az extension add --name azure-sphere
Sie müssen sich mit Azure CLI anmelden, um sich beim Azure-Abonnement anzumelden, das Sie zum Verwalten von Azure Sphere-Geräten verwenden möchten.
Nachdem eine Erweiterung installiert wurde, wird der Speicherort unter dem Wert der $AZURE_EXTENSION_DIR Shellvariable gefunden. Wenn diese Variable nicht festgelegt ist, befindet sich der Wert standardmäßig unter $HOME/.azure/cliextensions (Linux und macOS) bzw. %USERPROFILE%\.azure\cliextensions (Windows).
Tipp
Nach der Anmeldung wird eine Liste der Abonnements angezeigt, die Ihrem Azure-Konto zugeordnet sind. Stellen Sie sicher, dass Sie das Abonnement mit den erforderlichen Berechtigungen auswählen, indem Sie den az account set Befehl für die Azure Sphere-Erweiterung verwenden, um ordnungsgemäß zu funktionieren. Weitere Informationen zur Abonnementauswahl finden Sie unter Verwenden mehrerer Azure-Abonnements.
Verwalten der Azure Sphere-Erweiterung
Verwenden Sie den Befehl, um die installierten Versionen von Azure CLI-Erweiterungen anzuzeigen:
az version
Um die Azure Sphere-Erweiterung auf die neueste Version zu aktualisieren, verwenden Sie Folgendes:
az extension update --name azure-sphere
Um die Azure Sphere-Erweiterung zu deinstallieren, verwenden Sie Folgendes:
az extension remove --name azure-sphere
Allgemeine Azure Sphere CLI-Befehle
Sie können Azure Sphere-Befehle verwenden, indem Sie eine Windows-Eingabeaufforderung oder PowerShell eingeben az sphere .
Unter Linux können Sie eine beliebige Befehlszeilenschnittstelle (CLI) verwenden. Die CLI ermöglicht unter der Bash-Shell die Vervollständigung mit der TAB-TASTE.
In dieser Tabelle sind einige allgemeine Azure Sphere-Befehle und Links zu deren Referenzdokumentation aufgeführt.
| Befehl | Beschreibung |
|---|---|
az sphere catalog |
Verwalten Sie Ihren Katalog. |
az sphere ca-certificate |
Verwalten sie Zertifikate in Ihrem Katalog. |
az sphere deployment |
Verwalten Sie Bereitstellungen in Ihrem Katalog. |
az sphere device |
Verwalten von Azure Sphere-Geräten. |
az sphere device-group |
Verwalten sie Gerätegruppen in Ihrem Katalog. |
az sphere image |
Verwalten Sie Bilder in Ihrem Katalog. |
az sphere product |
Verwalten Sie Produkte in Ihrem Katalog. |
az sphere get-support-data |
Sammeln Sie Diagnosedaten zu Ihren System-, Cloud- und Gerätekonfigurationen. |
Azure CLI ermöglicht Ihnen das Einrichten von Konfigurationsoptionen , die die Verwendung von Azure Sphere CLI-Befehlen vereinfachen, indem Sie Standardwerte für Parameter wie das --resource-group, --subscriptionoder --catalog.
Geräteabhängige Befehle
Der Befehl funktioniert mit einem lokal angeschlossenen Azure Sphere-Gerät. Wenn Sie versuchen, den Befehl ohne angeschlossenes Gerät auszuführen, wird eine Fehlermeldung angezeigt. Weitere Informationen zu Gerätebefehlen finden Sie unter az kugelgerät
az sphere device claimaz sphere device recoveraz sphere device restartaz sphere device show-attachedaz sphere device show-os-versionaz sphere device app show-memory-statusaz sphere device app show-quotaaz sphere device app show-statusaz sphere device app startaz sphere device app stopaz sphere device capability show-attachedaz sphere device capability updateaz sphere device certificate addaz sphere device certificate deleteaz sphere device certificate listaz sphere device certificate showaz sphere device certificate show-quotaaz sphere device image list-installedaz sphere image-package showaz sphere device manufacturing-state showaz sphere device manufacturing-state updateaz sphere device network proxy applyaz sphere device network proxy deleteaz sphere device network proxy showaz sphere device network disableaz sphere device network enableaz sphere device network list-firewall-rulesaz sphere device network list-interfacesaz sphere device network show-diagnosticsaz sphere device network show-statusaz sphere device network update-interfaceaz sphere device sideload deleteaz sphere device sideload deployaz sphere device wifi addaz sphere device wifi disableaz sphere device wifi enableaz sphere device wifi forgetaz sphere device wifi listaz sphere device wifi reload-configaz sphere device wifi scanaz sphere device wifi showaz sphere device wifi show-status
Global verfügbare Argumente
Die folgenden globalen Parameter sind für die Azure Sphere-Erweiterung verfügbar:
| Parameter | Beschreibung |
|---|---|
--debug |
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen. |
--help -h |
Zeigt die Hilfenachricht an. |
--only-show-errors |
Zeigt nur Fehler an, wobei Warnungen unterdrückt werden. |
--output -o |
Ausgabeformat. Zulässige Werte: json, , jsonc, none, tabletsv, , . yamlyamlc Standardwert: json. |
--query |
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/. |
--subscription |
: Name oder ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren. |
--verbose |
Ausführlichkeit der Protokollierung erhöhen. Verwenden Sie --debug, um vollständige Debugprotokolle zu erhalten. |