Omówienie rozszerzenia Azure Sphere dla platformy Azure CLI

Narzędzie wiersza polecenia do zarządzania urządzeniami dołączonymi do usługi Azure Sphere i wdrożeniami w chmurze jest dystrybuowane jako rozszerzenie Azure CLI.

Instalowanie platformy Azure CLI i rozszerzenia Azure Sphere

Aby uzyskać rozszerzenie Azure Sphere dla platformy Azure CLI:

1. Zainstaluj platformę Azure CLI , jeśli jeszcze tego nie zrobiono.

2. Aby dodać rozszerzenie Azure Sphere, uruchom następujące polecenie:

   az extension add --name azure-sphere
   

Musisz zalogować się za pomocą platformy Azure CLI , aby zalogować się do subskrypcji Azure, za pomocą której chcesz zarządzać urządzeniami Usługi Azure Sphere.

Po zainstalowaniu rozszerzenia jego lokalizacja znajduje się pod wartością zmiennej powłoki $AZURE_EXTENSION_DIR . Jeśli ta zmienna jest niezłączona, domyślnie wartość jest $HOME/.azure/cliextensions ustawiona w systemach Linux i macOS oraz %USERPROFILE%\.azure\cliextensions w systemie Windows.

Wskazówka

Po zalogowaniu się zobaczysz listę subskrypcji skojarzonych z Twoim kontem Azure. Upewnij się, że wybierzesz subskrypcję z wymaganymi uprawnieniami, używając az account set polecenia rozszerzenia Azure Sphere, aby działało poprawnie. Aby uzyskać więcej informacji na temat wyboru subskrypcji, zobacz Korzystanie z wielu subskrypcji platformy Azure.

Zarządzanie rozszerzeniem Azure Sphere

Aby wyświetlić zainstalowane wersje rozszerzeń Azure CLI, użyj tego polecenia:

az version

Aby zaktualizować rozszerzenie Azure Sphere do najnowszej wersji, użyj:

az extension update --name azure-sphere

Aby odinstalować rozszerzenie Azure Sphere, użyj:

az extension remove --name azure-sphere

Typowe polecenia platformy Azure Sphere CLI

Możesz używać poleceń Azure Sphere, wpisując az sphere tekst w wierszu polecenia systemu Windows lub w programie PowerShell. W systemie Linux możesz użyć dowolnego interfejsu wiersza polecenia (CLI). W powłoce powłoki edycji cli ma pełną ukończenie tabulacji dla poleceń.

W poniższej tabeli wymieniono niektóre typowe polecenia usługi Azure Sphere oraz linki do dokumentacji referencyjnej.

Polecenia	Opis
az sphere catalog	Zarządzaj swoim katalogiem.
az sphere ca-certificate	Zarządzaj certyfikatami w wykazie.
az sphere deployment	Zarządzaj wdrożeniami w wykazie.
az sphere device	Zarządzaj urządzeniami usługi Azure Sphere.
az sphere device-group	Zarządzanie grupami urządzeń w wykazie.
az sphere image	Zarządzanie obrazami w wykazie.
az sphere product	Zarządzaj produktami w wykazie.
az sphere get-support-data	Zbierz dane diagnostyczne dotyczące konfiguracji systemu, chmury i urządzenia.

Platforma Azure CLI umożliwia skonfigurowanie opcji konfiguracji , które upraszczają korzystanie z poleceń platformy Azure Sphere CLI przez podanie domyślnych parametrów, takich jak --resource-group, --subscriptionlub --catalog.

Polecenia zależne od urządzenia

Polecenie działa z lokalnie dołączonym urządzeniem Azure Sphere. Jeśli spróbujesz wykonać polecenie bez podłączonego urządzenia, zostanie wyświetlony komunikat o błędzie. Aby uzyskać więcej informacji na temat poleceń urządzenia, zobacz urządzenie az sphere

• 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

Dostępne globalnie argumenty

Dla rozszerzenia Azure Sphere dostępne są następujące parametry globalne:

Parametr	Opis
--debug	Zwiększ poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Wyświetla komunikat pomocy.
--only-show-errors	Wyświetla tylko błędy, pomijając ostrzeżenia.
--output -o	Format wyjściowy. Dozwolone wartości: , , , , , tsv, yaml, . yamlctablenonejsoncjson Ustawienie domyślne: json.
--query	Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/ .
--subscription	: Nazwa lub identyfikator subskrypcji. Możesz skonfigurować subskrypcję domyślną przy użyciu .az account set -s NAME_OR_ID
--verbose	Zwiększ poziom szczegółowości rejestrowania. Służy --debug do pełnego tworzenia dzienników debugowania.