Udostępnij za pośrednictwem

Omówienie platformy Azure Sphere CLI

  • Artykuł

Środowisko kuli azure to zestaw poleceń używanych do zarządzania zasobami usługi Azure Sphere.

Dostępne są następujące polecenia:

Azure Sphere CLI i Azure Sphere classic CLI

Środowisko platformy Azure Sphere CLI jest instalowane razem z istniejącym interfejsem użytkownika systemu Windows i Linux, dzięki czemu masz dostęp do obu tych interfejsów. Klasyczny interfejs cli azure sphere nadal działa tak, jak zawsze.

Aby użyć cli azure sphere:

  • W systemie Windows użyj programu PowerShell lub standardowego wiersza polecenia systemu Windows.
  • W systemie Linux użyj dowolnej powłoki poleceń. Określ polecenie azsphere, jeśli ustawisz platformę Azure Sphere CLI jako domyślną opcję podczas instalacji zestawu SDK, lub polecenie azsphere_v2 , jeśli ustawisz klasyczny interfejs CLI azure Sphere jako domyślny.

Aby uzyskać szczegółowe informacje na temat funkcji i poleceń obsługiwanych przez platformę Azure Sphere CLI, zobacz Środowisko kuli azure Sphere , aby uzyskać szczegółowe informacje na temat funkcji i poleceń obsługiwanych przez środowisko Azure Sphere CLI.

Ważne

  • W systemie Windows skrót wiersza polecenia Azure Sphere Classic Developer Command Prompt może być używany tylko z klasycznym interfejsem cli platformy Azure Sphere.

Format wiersza polecenia

Wiersz polecenia azsphere ma następujący format:

azsphere [command] [subcommand] operation [parameters]

Ogólnie rzeczownik i polecenie to rzeczowniki, a operacja jest czasownikiem, dzięki czemu ta kombinacja identyfikuje zarówno akcję, jak i obiekt akcji. Większość poleceń i operacji ma zarówno pełną nazwę, jak i skrót. Na przykład polecenie urządzenia jest skrócone d.

Większość parametrów ma zarówno długą nazwę, jak i skrót. W wierszu polecenia wprowadź długą nazwę z dwoma łącznikami i skrótem z jednym łącznikiem. Na przykład dwa następujące polecenia są równoważne:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

Niektóre polecenia zezwalają na wiele wartości dla jednego parametru. W witrynie Azure Sphere CLI możesz podać jeden parametr, po którym następuje lista wartości rozdzielonych spacjami, a w klasycznym interfejsie cli w usłudze Azure Sphere lista wartości jest rozdzielona przecinkami. Na przykład:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

Znaki cudzysłowu i znaki ucieczki

Podczas pracy z poleceniami platformy Azure Sphere CLI pamiętaj o tym, jak powłoka używa cudzysłowów i unika znaków. Jeśli obsługujesz skrypty używane w różnych powłokach, musisz zrozumieć, czym się różnią.

Na przykład:

Polecenia zależne od chmury

Następujące polecenia azsphere wymagają połączenia z chmurą i logowania się do usługi zabezpieczeń Azure Sphere:

  • ca-certificate
  • grupa urządzeń
  • get-support-data
  • Obrazu
  • Logowania
  • Wyloguj
  • Produktu
  • zarejestruj użytkownika
  • Roli
  • pokaż użytkownika
  • Dzierżawy

Ponadto następujące polecenia urządzenia azsphere wymagają również połączenia z chmurą:

Polecenie urządzenia azsphere Komentarze
Możliwości Wymaga usługi Azure Sphere Security Service do pobierania możliwości urządzenia
Roszczenia
enable-cloud-test
włączanie i rozwijanie
Obrazu
Listy
Odzyskać Wymaga łączności internetowej, ale nie logowania się do usługi zabezpieczeń Azure Sphere
Pokaż
show-count
show-deployment-status
show-os-version Wymaga łączności internetowej, ale nie logowania się do usługi zabezpieczeń Azure Sphere
Aktualizacji

Polecenia zależne od funkcji urządzenia

Następujące polecenia urządzenia azsphere wymagają użycia funkcji urządzenia dla urządzeń w stanie produkcyjnym DeviceComplete:

Operacji Opis
App Zarządzaj aplikacjami na dołączonym urządzeniu.
Możliwości Zarządzaj konfiguracjami funkcji urządzenia. Wymagane do aktualizacji funkcji.
Certyfikat Zarządzaj magazynem certyfikatów urządzenia.
Obrazu Zarządzaj obrazami urządzeń.
stan produkcji Zarządzaj stanem produkcji dołączonych urządzeń. Wymagane do aktualizacji stanu produkcyjnego.
Ponownie uruchomić Uruchom ponownie podłączone urządzenie.
show-deployment-status Pokaż stan wdrożenia systemu operacyjnego i aplikacji na dołączonym urządzeniu.
show-os-version Pokaż wersję systemu operacyjnego na dołączonym urządzeniu.
Pobieraj Wdrażanie aplikacji i zarządzanie nimi na dołączonym urządzeniu. Wymagane do wdrożenia ładunku bezpośredniego i usunięcia ładowania bezpośredniego.
Wifi Zarządzaj konfiguracjami Wi-Fi dołączonego urządzenia.

Jeśli spróbujesz uruchomić te polecenia bez użycia funkcji, zostanie wyświetlony komunikat o błędzie z informacją o uruchomieniu azsphere device enable-development lub użyciu azsphere device capability w celu pobrania i wybrania pliku funkcji dla urządzenia.