Omówienie rozszerzenia usługi Azure Sphere dla interfejsu wiersza polecenia platformy Azure

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 interfejsu wiersza polecenia platformy Azure.

Instalowanie interfejsu wiersza polecenia platformy Azure i rozszerzenia usługi Azure Sphere

Aby uzyskać rozszerzenie usługi Azure Sphere dla interfejsu wiersza polecenia platformy Azure:

1. Zainstaluj interfejs wiersza polecenia platformy Azure, jeśli jeszcze tego nie zrobiono.

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

   az extension add --name azure-sphere
   

Aby zalogować się do subskrypcji platformy Azure, której chcesz użyć do zarządzania urządzeniami usługi Azure Sphere, musisz zalogować się przy użyciu interfejsu wiersza polecenia platformy Azure.

Po zainstalowaniu rozszerzenia jego lokalizacja znajduje się pod wartością zmiennej $AZURE_EXTENSION_DIR powłoki. Jeśli nie ustawiono tej zmiennej, domyślnie wartością jest $HOME/.azure/cliextensions w systemie Linux i macOS i %USERPROFILE%\.azure\cliextensions w systemie Windows.

Napiwek

Po zalogowaniu zostanie wyświetlona lista subskrypcji skojarzonych z kontem platformy Azure. Upewnij się, że wybrano subskrypcję z wymaganymi uprawnieniami, używając az account set polecenia rozszerzenia usługi Azure Sphere do poprawnego działania. Aby uzyskać więcej informacji na temat wyboru subskrypcji, zobacz Korzystanie z wielu subskrypcji platformy Azure.

Zarządzanie rozszerzeniem usługi Azure Sphere

Aby wyświetlić zainstalowane wersje rozszerzeń interfejsu wiersza polecenia platformy Azure, użyj polecenia :

az version

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

az extension update --name azure-sphere

Aby odinstalować rozszerzenie usługi Azure Sphere, użyj:

az extension remove --name azure-sphere

Typowe polecenia interfejsu wiersza polecenia usługi Azure Sphere

Polecenia usługi Azure Sphere można używać, wpisując polecenie az sphere w wierszu polecenia systemu Windows lub w programie PowerShell. W systemie Linux można użyć dowolnego interfejsu wiersza polecenia (CLI). Interfejs wiersza polecenia obsługuje pełne wypełnianie po naciśnięciu klawisza TAB dla poleceń w obszarze powłoki bash.

W tej tabeli wymieniono niektóre typowe polecenia usługi Azure Sphere i linki do ich dokumentacji referencyjnej.

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

Interfejs wiersza polecenia platformy Azure umożliwia konfigurowanie opcji konfiguracji, które upraszczają korzystanie z poleceń interfejsu wiersza polecenia usługi Azure Sphere, zapewniając wartości domyślne parametrów, takich jak --resource-group, --subscriptionlub --catalog.

Polecenia zależne od urządzenia

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

• 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

Globalnie dostępne argumenty

Następujące parametry globalne są dostępne dla rozszerzenia usługi Azure Sphere:

Parametr	Opis
--debug	Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
--help -h	Wyświetla komunikat pomocy.
--only-show-errors	Pokazuje tylko błędy, pomijając ostrzeżenia.
--output -o	Format danych wyjściowych. Dozwolone wartości: json, , nonejsonc, tabletsv, , yaml, yamlc. Wartość domyślna: json.
--query	Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
--subscription	: nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
--verbose	Zwiększ szczegółowość rejestrowania. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.