Enhet

Artikel
09/07/2023

Hanterar Azure Sphere-enheter.

Drift	Beskrivning
App	Ändrar status för program på en enhet.
Kapacitet	Hanterar enhetsfunktioner.
Certifikat	Hanterar lagring av enhetscertifikat.
Hävdar	Gör anspråk på en tidigare oanvänd enhet till Azure Sphere-klientorganisationen.
enable-cloud-test	Konfigurerar en enhet för att inaktivera felsökning och ta emot uppdateringar.
aktivera-utveckling	Konfigurerar en enhet för lokal felsökning.
Bild	Hanterar avbildningar för en enhet.
Lista	Visar alla enheter i klientorganisationen.
bifogad lista	Listor de anslutna enheterna.
tillverkningstillstånd	Hanterar den anslutna enhetens tillverkningsstatus.
Nätverk	Innehåller information om status för nätverksgränssnitt på enheten.
Återställa	Använder särskilt återställningsläge för att läsa in ny inbyggd programvara på enheten.
återskanna	Omskanna anslutna enheter som ett felsökningshjälpmedel (endast Windows).
Starta	Startar om den anslutna enheten.
Visa	Visar information om enhetens uppdateringskonfiguration.
visa bifogad	Visar information om den anslutna enheten från själva enheten.
visa antal	Visar det totala antalet enheter i en klientorganisation.
show-deployment-status	Visar status för den senaste distributionsuppdateringen.
show-os-version	Visar operativsystemets version för lokala enheter.
separat inläsning	Läser in en bild på den anslutna enheten.
Uppdatering	Uppdateringar en enhet genom att placera den i en viss enhetsgrupp.
Wifi	Hanterar enhetens Wi-Fi konfiguration.

App

Hanterar program på enheten.

Många av appalternativen kräver apputvecklingsfunktionen , som kan förvärvas med hjälp av aktivering av azsfärenheter. Om du vill starta, stoppa eller felsöka ett SDK-signerat program eller ett produktionssignerat program måste enheten ha funktionen appUtveckling .

Du kan använda azsfärenhetsappstopp och azsfärenhetsappstart för att starta om ett program som kan köras i realtid för att avgöra vilken realtidskärna den körs på.

Drift	Beskrivning
show-memory-stats	Visar minnesstatistiken för program på den anslutna enheten.
visa-kvot	Visar mängden lagringsutrymme som används av det aktuella programmet på enheten.
visa-status	Returnerar status för det aktuella programmet på enheten.
Börja	Startar programmet som läses in på enheten.
Stanna	Stoppar programmet som körs på enheten.

app show-memory-stats

Visar minnesstatistik för program på den anslutna enheten. Det här kommandot är bara tillgängligt om funktionen appUtvecklingsenhet är konfigurerad. Ytterligare information visas om minnesallokeringsspårning för heap har konfigurerats.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device app show-memory-stats
 -------------- -------------
 Name           Usage (bytes)
 ============================
 Total          434176
 User Mode      147456
 Peak User Mode 147456
 -------------- -------------

visa-kvot för app

Visar mängden avstängt lagringsutrymme som tilldelats och används på den anslutna enheten.

Du anger den mutable lagringskvoten i programmanifestet och operativsystemet Azure Sphere tillämpar kvoter när sektorerna för filen allokeras. Om du minskar MutableStorage värdet ändras inte mängden lagringsutrymme som används, men det tilldelade värdet rapporteras på ett annat sätt. Om programmet till exempel redan har använt 16 kB och du ändrar MutableStorage värdet till 8 kB, rapporterar kommandot att programmet använder 16 kB av 8 kB allokerat. Data finns kvar på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-i, --component-id	GUID	Anger ID för komponenten för vilken kvotinformation ska hämtas. Om det utelämnas visas kvotinformation för alla komponenter.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.

app show-status

Visar aktuell status för programmen på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-i, --component-id	GUID	Anger ID för komponenten för vilken status ska visas. Om det utelämnas visas status för alla komponenter.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running

appstart

Startar program på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
--felsökningsläge	Boolean	Startar programmet för felsökning. Måste `--component-id` tillhandahållas.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-i, --component-id	GUID	Anger ID för komponenten som ska startas. Om argumentet utelämnas startar alla program.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core     : High-level

appstopp

Stoppar programmen på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-i, --component-id	GUID	Anger ID för komponenten som ska stoppas. Om det utelämnas stoppar du alla program.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped

Kapacitet

Hanterar enhetsfunktioner. Enhetsfunktionerna avgör vilka åtgärder som kan utföras på en enskild Azure Sphere-enhet.

Enhetsfunktionerna laddas ned som en fil från Azure Sphere Security Service med hjälp av kommandot för nedladdning av azsfärenheter . Du kan använda enhetsfunktionskonfiguration på den anslutna Azure Sphere-enheten med uppdateringskommandot för azsfärenheten och du kan skapa en underhållssession med hjälp av kommandot azsfärenhetskapacitet . Mer information om enhetsfunktioner finns i Enhetsfunktioner och kommunikation.

Drift	Beskrivning
Hämta	Laddar ned en konfiguration av enhetsfunktioner från Azure Sphere-säkerhetstjänsten.
Välj	Väljer en nedladdad funktionsfil som ska användas för en underhållssession.
visa bifogad	Visar funktionskonfigurationen för den anslutna enheten.
Uppdatering	Tillämpar en enhetsfunktionskonfiguration på den anslutna enheten.

funktionsnedladdning

Laddar ned en enhetsfunktion från Azure Sphere-säkerhetstjänsten.

Med funktionen appUtveckling kan du läsa in SDK-signerade program separat och starta, stoppa, felsöka eller ta bort ett program på enheten. Utan appUtvecklingsfunktionen kan endast molninstallerade program läsas in och startas, stoppas, felsökas och tas bort är förbjudna. AppUtvecklingsfunktionen används som en del av azsfärenhetens aktivera-utvecklingskommando.

Nedladdning av funktionen fieldServicing resulterar i en fil som innehåller funktionen för en enda Azure Sphere-enhet. Funktionsfilen fieldServicing laddas ned till den lokala datorn och kan användas tillsammans med kommandot azsfärenhet.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
--Typ	Funktionstyp	Anger vilken typ av enhetsfunktion som ska laddas ned. Värdena är appUtveckling, fieldServicing eller inget. Använd ingen för att ta bort funktionen appUtveckling eller funktionen fieldServicing .

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på. Den här parametern krävs när flera enheter är anslutna eller när ingen enhet är ansluten. Den anslutna enheten används som standard. Du kan ange ett enhets-ID för en enhet som inte är ansluten, eller så kan du ange IP-adressen eller lokalt anslutnings-ID för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
--Destination	Sträng	Anger sökvägen och filnamnet som funktionskonfigurationen ska sparas för. Ta med en absolut eller relativ sökväg. Om du inte anger en sökväg lagras filen i den lokala katalogen med namnkonventionsfunktionens< typ> åtta tecken av enhets-ID.cap<>.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
 --------------------------------------------
 Result
 ============================================
 C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
 --------------------------------------------

funktion välj

Väljer en funktionsfil som ska användas med den anslutna Azure Sphere-enheten.

Azsfärenhetens funktionsvalkommando kan användas med valfri funktion, men används oftast med fieldServicing-funktionen för att aktivera en underhållssession. Alla användarroller har åtkomst till azsfärenhetens funktionsvalskommando .

När du använder funktionen fieldServicing är kommunikation aktiverad mellan Azure Sphere-enheten och den lokala datorn som innehåller funktionsfilen. Funktionsfilen fieldServicing används för en session mellan den lokala datorn och Azure Sphere-enheten, och varje kommando i sessionen förbereds med ett meddelande som anger vilken funktionsfil som används.

Om du vill avsluta en underhållssession använder du azsfärenhetens funktionsval --none.

Valfria parametrar

Parametern	Typ	Beskrivning
--capability-file	Sträng	Anger sökvägen och filnamnet för den konfigurationsfil för enhetsfunktioner som ska väljas. Du kan ange en relativ eller absolut sökväg.
-n, --none	-	Tar bort alla tidigare valda enhetsfunktionskonfigurationer.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.

funktionsvisningsansluten

Visar funktionskonfigurationen som lagras på den anslutna enheten.

Observera

Kommandot visar de funktioner som konfigurerats med en funktionsfil och vissa, men inte alla, funktioner som finns som standard på anslagstavlor.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableFieldServicing
 --------------------

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableAppDevelopment
 --------------------

funktionsuppdatering

Tillämpar en enhetsfunktionskonfiguration på den anslutna enheten.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
--capability-file	Sträng	Anger sökvägen och filnamnet för den enhetsfunktionsfil som ska tillämpas. Du kan ange en relativ eller absolut sökväg.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på. Den här parametern krävs när flera enheter är anslutna eller när ingen enhet är ansluten. Den anslutna enheten används som standard. Du kan ange ett enhets-ID för en enhet som inte är ansluten, eller så kan du ange IP-adressen eller lokalt anslutnings-ID för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.

Certifikat

Hanterar certifikat på den anslutna enheten.

Drift	Beskrivning
Add	Lägger till ett certifikat i certifikatarkivet på den anslutna enheten.
Ta bort	Tar bort ett certifikat från den bifogade enhetens certifikatarkiv.
Lista	Listor certifikat-ID:na som är tillgängliga i certifikatarkivet för den anslutna enheten.
Visa	Visar information om ett certifikat i certifikatarkivet för den anslutna enheten.
visa-kvot	Visar tillgängligt ledigt utrymme i certifikatarkivet för den anslutna enheten.

certifikattillägg

Lägger till ett certifikat i certifikatarkivet för den anslutna enheten.

Rotcertifikatutfärdare och klientcertifikat måste vara i PEM-format för att kunna läsas in på Azure Sphere-enheten. Du måste hämta rotcertifikatutfärdarcertifikatet från lämplig server tillsammans med klientcertifikatet och den privata nyckeln (och eventuellt ett lösenord för din privata nyckel) för enheten. Varje certifikat måste genereras och signeras av lämplig server i EAP-TLS-nätverket. Nätverksadministratören eller säkerhetsteamet kan ange den information du behöver för att hämta certifikaten. Mer information om hur du skaffar rotcertifikatet för certifikatutfärdare finns i Hämta och distribuera certifikat för EAP-TLS-nätverk.

Försiktighet

Eftersom certifikat-ID:er är systemomfattande för både klient- och rotcertifikatutfärdarcertifikat kan ett azsfärkommando eller ett funktionsanrop som lägger till ett nytt certifikat skriva över ett certifikat som har lagts till av ett tidigare kommando- eller funktionsanrop, vilket kan orsaka fel i nätverksanslutningen. Vi rekommenderar starkt att du utvecklar tydliga procedurer för certifikatuppdatering och väljer certifikat-ID:er noggrant.

Mer information finns i Certifikat-ID:t .

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-i, --cert-id	Sträng	Anger identifieraren för certifikatet som ska läggas till. En strängidentifierare (upp till 16 tecken). Giltiga tecken är versaler (A-Z), gemener (a-z), siffror (0–9), understreck (_), punkt (.) och bindestreck (-). Identifieraren används också i Wi-Fi konfigurationer för EAP-TLS-nätverk.
--cert-type	Sträng	Anger vilken typ av certifikat som ska läggas till, antingen klient eller rotkälla.
-p, --public-key-file	Sträng	Anger sökvägen till en .pem-fil med offentlig nyckelcertifikat. Du kan ange en relativ eller absolut sökväg.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
--private-key-file	Sträng	Anger sökvägen till en .pem-fil för klientcertifikat med privat nyckel. Obligatoriskt när du lägger till ett certifikat för typklient. Du kan ange en relativ eller absolut sökväg.
-w, --private-key-password	Sträng	Anger ett valfritt lösenord för klientens privata nyckel. Lösenordet krävs när du lägger till en privat nyckel för klientcertifikat som är krypterad.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.

azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.

ta bort certifikat

Tar bort ett certifikat från den bifogade enhetens certifikatarkiv.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-c, --certificate Eller --cert-id [Dras tillbaka]	Sträng	Anger identifieraren för certifikatet som ska tas bort. Argumentet `--cert-id` dras tillbaka och tas bort i en framtida version. Mer information finns i Viktiga ändringar (tillbakadragna funktioner) i Azure Sphere CLI.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device certificate delete --certificate certclient

certifikatlista

Listor de certifikat som är tillgängliga i enhetens certifikatarkiv.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device certificate list
 -----------
 Identifiers
 ===========
 rootCert
 -----------

certifikatvisning

Visar information om ett enskilt certifikat i enhetens certifikatarkiv.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-c, --certificate Eller --cert-id [Dras tillbaka]	Sträng	Anger identifieraren för certifikatet som informationen ska visas för. Argumentet `--cert-id` dras tillbaka och tas bort i en framtida version. Mer information finns i Viktiga ändringar (tillbakadragna funktioner) i Azure Sphere CLI.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
 Id         StartDate           EndDate             SubjectName                         IssuerName
 ==========================================================================================================================
 certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

visningskvot för certifikat

Visar tillgängligt ledigt utrymme i certifikatarkivet för den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------

Hävdar

Gör anspråk på en tidigare enhet utan ansvar för den aktuella Azure Sphere-klientorganisationen.

Viktigt

Innan du gör anspråk på enheten kontrollerar du att du är inloggad på rätt Azure Sphere-klientorganisation. En enhet kan bara begäras en gång. När det påstås kan en enhet inte flyttas till en annan klientorganisation.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på. Den här parametern krävs när flera enheter är anslutna eller när ingen enhet är ansluten. Den anslutna enheten används som standard. Du kan ange ett enhets-ID för en enhet som inte är ansluten, eller så kan du ange IP-adressen eller lokalt anslutnings-ID för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.
--Kraft	Boolean	Tvingar fram anspråk på en enhet i den aktuella användarens valda Azure Sphere-klientorganisation.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.

enable-cloud-test

Läser upp den anslutna enheten för att testa molninläsning genom att inaktivera programutveckling, ta bort befintliga program och aktivera molninlästa programuppdateringar.

Den kräver att en enhet är ansluten till datorn och endast fungerar på den anslutna enheten.

Mer specifikt : enable-cloud-test:

Tar bort appUtvecklingsfunktionen för den anslutna enheten.
Tilldelar enheten till en enhetsgrupp som möjliggör molninlästa programuppdateringar.
Startar om enheten.

Vilka specifika uppgifter som aktivera-molntest utför beror på om en produkt- och enhetsgrupp redan har tilldelats för den här enheten.

Om azsfärenhet enable-cloud-test körs utan parametrar placeras enheten i gruppen Fälttestenhet för enhetens aktuella produkt. Det här är en av standardenhetsgrupperna som skapas automatiskt för varje produkt, vilket möjliggör programuppdateringar. Ett fel returneras om enheten inte har en produkt eller om en grupp för fälttestenheter inte finns i den.

Om en produkt anges placeras enheten i gruppen Fälttestenhet för produkten. Ett fel returneras om den här enhetsgruppen inte finns.

Om en enhetsgrupp anges placeras enheten i den. Ett fel returneras om målenhetsgruppen inte aktiverar programuppdateringar.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-p, --product	GUID eller namn	Anger målprodukten. När detta anges flyttas enheten till standardgruppen för fälttestenhet för den här produkten, såvida inte `--device-group` även anges. Du kan ange antingen ID eller namn på Azure Sphere-produkten.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.
-g, --device-group	GUID eller namn	Anger den enhetsgrupp som enheten ska flyttas till. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens `<product-name/device-group-name>` namn i formatet. Som standard är det här produktgruppen fälttestenhet.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

Exempel 1. Tilldela enheten till en befintlig enhetsgrupp med dess ID

I det här exemplet tilldelas den anslutna enheten till en befintlig produkt- och enhetsgrupp.

azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')

Exempel 2. Tilldela enhet till en annan enhetsgrupp

Det här exemplet liknar föregående exempel, men behåller den befintliga produkten för enheten. Här ändrar åtgärden enable-cloud-test enhetsgruppen som enheten tillhör och tar bort funktionen appUtveckling. Det här kommandot är användbart för att flytta en enhet från en utvecklingsmiljö som inte aktiverar programuppdateringar till en produktionsmiljö som gör det.

azsphere device enable-cloud-test --device-group "Marketing/Field Test"

Exempel 3. Tilldela enhet efter produktnamn

Det här exemplet möjliggör molninläsning och tilldelar enheten till en produkt med namn.

azsphere device enable-cloud-test --product DW100

aktivera-utveckling

Aktiverar en enhet för utveckling genom att aktivera separat inläsning och felsökning på enheten och genom att tilldela den till en enhetsgrupp som inaktiverar programuppdateringar från molnet. Som standard är detta gruppen Utvecklingsenhet för enhetens produkt, men andra enhetsgrupper kan anges. Använd inte i tillverkningsscenarier. Mer information finns i Tillverkning av anslutna enheter .

Mer specifikt , enable-development:

Laddar ned och tillämpar appUtvecklingsfunktionen för den anslutna enheten.
Tilldelar enheten till en enhetsgrupp som inte aktiverar molninlästa programuppdateringar.
Startar om enheten.

Om du kör azsfärenhetens aktivera-utvecklingskommando utan parametrar:

Om enheten inte redan har en produkt- eller enhetsgrupp laddas kommandot ned och tillämpar appUtvecklingsfunktionen för den anslutna enheten och startar om enheten. Alla befintliga appar finns kvar på enheten och operativsystemet uppdateras. Installationsprocessen för att göra anspråk på din enhet och Snabbstart för att skapa ett program på hög nivå påverkas inte.
Om enheten redan har en produkt flyttar kommandot enheten till produktens enhetsgrupp för utveckling . Som standard är programuppdateringar inaktiverade för den här gruppen, vilket säkerställer att separat inlästa appar inte skrivs över.

Om du kör azsfärenhetens aktivera-utvecklingskommando med parametern --product :

Places enheten i gruppen Utvecklingsenhet för produkten. Ett fel returneras om den här enhetsgruppen inte finns.

Om du kör azsfärenhetens aktivera-utvecklingskommando med parametern --device-group :

Places anges enheten i den angivna enhetsgruppen. Målenhetsgruppen får inte aktivera programuppdateringar eller så returneras ett fel.

I vissa fall rapporterar azsfärenhetens aktiveringsaktivering ett fel och föreslår att du gör anspråk på enheten. Om du redan har gjort anspråk på enheten använder du azsfärklientorganisationen visa vald för att säkerställa att du är inloggad på klientorganisationen där du gjorde anspråk på enheten. Annars använder du azsfärinloggning för att logga in på rätt klientorganisation. När du är säker på att du är inloggad på rätt klientorganisation använder du azsfärenhetens anspråk för att göra anspråk på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-g, --device-group	GUID eller namn	Anger den enhetsgrupp som enheten ska flyttas till. Om det utelämnas tilldelar du enheten till en standardgrupp. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens `<product-name/device-group-name>` namn i formatet.
-r, --enable-rt-core-felsökning	Boolean	Installerar drivrutiner som krävs för att felsöka program som körs i en kärna i realtid. Det här alternativet kräver administratörsbehörigheter.
-p, --product	GUID eller namn	Anger målprodukten. När du anger det här värdet flyttas enheten till standardgruppen för utvecklingsenhet för den här produkten, såvida inte `--device-group` även anges. Du kan ange antingen ID eller namn på Azure Sphere-produkten.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')

Bild

Returnerar information om avbildningarna som är installerade på eller riktade till den anslutna enheten.

Drift	Beskrivning
listinstallerad	Innehåller information om de avbildningar som för närvarande är installerade på den anslutna enheten.
list riktad	Innehåller information om de bilder som är riktade till den anslutna enheten.

avbildningslista installerad

Listor avbildningarna som är installerade på den anslutna enheten. Listan med information innehåller komponent- och avbildnings-ID:na.

Observera

Långa bildnamn trunkeras med 31 tecken.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-f, --full	Boolean	Listor alla programvarubilder som är installerade på enheten. Som standard visas endast programavbildningar, felsökningsprogram och avbildningar för anslagstavlor.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     dc6205bd-4478-4c9b-81ad-5e41ac23ed68
 --> CrashApplicatio
   --> Image type:   Application
   --> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
   --> Image ID:     cc77124e-6447-4c0f-9f99-fc0ad5ef46ef

bildlista riktad

Listor avbildningarna som har laddats upp till Azure Sphere-säkerhetstjänsten och installeras när enheten uppdateras. Mer information om hur du ser till att din Azure Sphere-enhet är redo att acceptera molnbaserade programuppdateringar finns i Aktivera molnbaserad distribution för din enhet.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på. Den här parametern krävs när flera enheter är anslutna eller när ingen enhet är ansluten. Den anslutna enheten används som standard. Du kan ange ett enhets-ID för en enhet som inte är ansluten, eller så kan du ange IP-adressen eller lokalt anslutnings-ID för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.
-f, --full	Boolean	Listor alla avbildningar i Azure Sphere-klientorganisationen.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device image list-targeted
 ----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
 Name                    ComponentId                          ImageId                              ImageType       RegionalDataBoundary 
 =======================================================================================================================================
 HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications    None   
 ----------------------- ------------------------------------ ------------------------------------ -------------------------------------

Lista

Listor alla enheter i en klientorganisation. Listan trunkerar efter de första 500 enheterna.

Valfria parametrar

Parametern	Typ	Beskrivning
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device list
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Du kan använda parametern --query för att anpassa resultatet som visas för det här kommandot. Mer information finns i Fråge-CLI-kommandoutdata.

I följande exempel visas hur du väljer bara Enhets-ID och Produkt-ID:

azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Tips

Kör azsfärprodukten visa --produktprodukt-ID <> för att visa produktnamnet eller azsfärenhetsgruppens show --device-group <devicegroup-ID> för att visa enhetsgruppsnamnet.

bifogad lista

Listor enheterna som är anslutna till den lokala datorn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
  --> Is responsive: yes
  --> IP address: 192.128.48.1
  --> Connection path: 21143

tillverkningstillstånd

Hanterar den anslutna enhetens tillverkningsstatus.

Drift	Beskrivning
Visa	Visar den anslutna enhetens tillverkningsstatus.
Uppdatering	Uppdateringar den anslutna enhetens tillverkningsstatus.

Försiktighet

Ändringar i tillverkningstillståndet är permanenta och oåterkalleliga.

tillverkningsstatusvisning

Visar den anslutna enhetens tillverkningsstatus.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------

tillverkningstillståndsuppdatering

Uppdateringar den anslutna enhetens tillverkningsstatus. Mer information finns i Ange enhetstillverkningstillstånd.

Försiktighet

Ändringar i tillverkningstillståndet är permanenta och oåterkalleliga.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-s, --state	Tillverkningstillstånd	Anger tillverkningstillståndet som ska anges för enheten. Möjliga tillstånd är bland annat `DeviceComplete` och `Module1Complete`.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.

Nätverk

Innehåller information om status för nätverksgränssnitt på den anslutna enheten.

Drift	Beskrivning
Aktivera	Aktiverar ett nätverksgränssnitt på den anslutna enheten.
Inaktivera	Inaktiverar ett nätverksgränssnitt på den anslutna enheten.
list-firewall-rules	Listor brandväggsreglerna för den anslutna enheten.
listgränssnitt	Listor nätverksgränssnitten för den anslutna enheten.
Proxy	Hanterar inställningarna för nätverksproxy.
show-diagnostics	Visar nätverksdiagnostik för ett eller alla trådlösa nätverk på den anslutna enheten.
visa-status	Visar nätverksstatus för den anslutna enheten.
update-interface	Uppdateringar en nätverksgränssnittskonfiguration för enheten.

nätverksaktivera

Aktiverar ett nätverksgränssnitt på den anslutna enheten.

Observera

Det här kommandot stöds för att konfigurera Ethernet eth0 och wlan0 anslutningar. Ett fel returneras om du konfigurerar lo eller azspheresvc.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
--Gränssnitt	Sträng	Anger vilket gränssnitt som ska aktiveras.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

nätverksaktivera

Inaktiverar ett nätverksgränssnitt på den anslutna enheten.

Observera

Det här kommandot stöds för att konfigurera Ethernet eth0 och wlan0 anslutningar. Ett fel returneras om du konfigurerar lo eller azspheresvc.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
--Gränssnitt	Sträng	Anger vilket gränssnitt som ska aktiveras.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

network list-firewall-rules

Listor brandväggsreglerna för den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Följande regler visas:

Firewall Ruleset Name: Visar namnet på regeluppsättningsblocket för brandväggen.
- Värdena är PREROUTING, POSTROUTING, INPUT, FORWARD och OUTPUT.
Is Ruleset Valid: Visar status för regeluppsättningen. Värdena är Sant eller Falskt.
Regler för brandväggsregler: Visar värdena för följande regler:
- Käll-IP: Visar IP-adressen för den avsändnde datorn.
- Källmask: Visar nätverksmasken för den avsändnde datorn.
- Mål-IP: Visar måldatorns IP-adress.
- Målmask: Visar nätverksmasken för destomation-datorn.
- UID: Visar användaridentifieringen som tillämpas på regeln. 4294967295 (0xFFFFFFFF) innebär att inget UID tillämpades och därför gäller det för alla.
- Åtgärd: Visar den åtgärd som ska vidtas. Värdena kan accepteras eller tas bort.
- Interface IN-namn: Visar namnet på inmatningsgränssnittet. Till exempel wlan0.
- Namn på gränssnittsutgång: Visar namnet på utdatagränssnittet. Till exempel wlan0.
- Tillstånd: Visar anslutningstillståndet. Värdena är inga, etablerade eller relaterade.
- TCP-mask: Visar matrisen med TCP-masker. Värdena är fin, syn, rst, psh, ack och urg.
- TCP Cmp: Visar matrisen med TCP-flaggor. Värdena är urg, ack, psh, rst, syb och fin.
- TCP Inv: Boolesk anger att känslan av TCP-flaggor ska inverteras. Värdena är Sant eller Falskt.
- Protokoll: Visar brandväggsregelns protokoll. Värdena är icmp, igmp, tcp, udp.
- Källportintervall: Visar portintervallet från källan som skickar trafiken. Värdet kan vara mellan 0 och 65535.
- Målportintervall: Visar portintervallet på målet som tar emot trafiken. Värdet kan vara mellan 0 och 65535.
- Paket: Visar antalet paket.
- Byte: Visar antalet byte.

En kort sammanfattning av flaggorna visas på följande sätt:

URG: Viktigt fält för brådskande pekare
ACK: Bekräftelsefält betydande
PSH: Push-funktion
RST: Återställ anslutningen
SYN: Synkronisera sekvensnummer
FIN: Inga fler data från avsändaren

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network list-firewall-rules
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 Ruleset     IsValid SourceIp     SourceMask      DestinationIp   DestinationMask UID        Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes  TcpMask TcpCmp
 =====================================================================================================================================================================================================
 PREROUTING  False   None         None            None            None            None       None   None            None   None     None            None                 None    None   None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  any      0-65535         0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 True   tcp      0-65535         0-65535              823     394754 syn,ack syn
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    192.168.35.1 <value>         <value>         <value>         <value>     accept azspheresvc     False  any      0-65535         0-65535              15      780    None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------

nätverkslistgränssnitt

Listor nätverksgränssnitten för den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network list-interfaces
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses   ConnectedToInternet IpAssignment HardwareAddress
 ========================================================================================================================
 azspheresvc   True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 eth0          True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 lo            True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 wlan0         True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

nätverksproxy

Hanterar proxyadressanvändning för nätverksanslutning. Mer information om hur du konfigurerar en Azure Sphere-enhet för att ansluta till Internet via en proxyserver finns i Ansluta via en proxyserver.

Observera

Endast HTTP-proxyservrar stöds för närvarande.

Drift	Beskrivning
proxy används	Konfigurerar nätverksproxyn på den anslutna enheten.
proxyborttagning	Tar bort proxyanslutningen på den anslutna enheten.
proxyvisning	Visar proxyanslutning på den anslutna enheten.

proxy används

Konfigurerar nätverksproxyn på den anslutna enheten.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-a, --address	Sträng	Anger nätverksadressen för proxyn som ska användas.
-t, --authentication	Sträng	Anger vilken autentiseringstyp som ska användas. Tillåtna värden: `anonymous` eller `basic`. Om proxyn kräver ett användarnamn och lösenord anger du det till `basic`, annars använder du `anonymous`.
-r, --port	Heltal	Anger den port på nätverksadressen som ska användas. Värdet måste vara lika med eller mindre än 65535.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
--Aktivera	Sträng	Anger om proxyn ska vara aktiverad. Du måste ange antingen `--enable` eller `--disable`.
--Inaktivera	Sträng	Anger om proxyn ska inaktiveras. Du måste ange antingen `--enable` eller `--disable`.
-n, --no-proxy-addresses	Sträng	Anger en matris med blankstegsavgränsade nätverksadresser som enheten ska undvika för proxyanslutning.
-p, --password	Sträng	Anger lösenordet för proxyautentisering Som endast används för grundläggande autentisering. Maximal längd: 64 tecken.
-u, --användarnamn	Sträng	Anger användarnamnet för proxyautentisering. Används endast för grundläggande autentisering. Maximal längd: 64 tecken.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

proxyborttagning

Tar bort proxyanslutningen på den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network proxy delete

proxyvisning

Visar proxyanslutning på den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network proxy show
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

nätverksvisningsdiagnostik

Visar diagnostik för ett eller alla Wi-Fi nätverk på den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-n, --network	Heltal	Anger ID för det Wi-Fi nätverk för vilket diagnostik ska visas.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network show-diagnostics
 ------------------------- --------- ----- ------------- --------------- --------
 Timestamp                 NetworkId Ssid  ConfigState   ConnectionState Error
 ================================================================================
 2021-06-16T20:51:29+00:00 0         <value> temp-disabled disconnected    WrongKey
 ------------------------- --------- ----- ------------- --------------- --------

nätverksvisningsstatus

Visar nätverksstatus för den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network show-status
 --------------------------- --------------- -----
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 =================================================
 True                        complete        ready
 --------------------------- --------------- -----

nätverksuppdateringsgränssnitt

Uppdateringar Ethernet-nätverksgränssnittet för enheten. Mer information om hur du anger enhetens MAC-adress finns i Konfigurera enheten för Ethernet.

Observera

Det här kommandot stöds för att konfigurera Ethernet-anslutningar eth0 . Ett fel returneras om du konfigurerar lo, azspheresvc eller wlan0.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
--hardware-address	Sträng	Anger maskinvaruadressen för enheten i något av följande format: `AA:BB:33:DD:EE:FF` eller `aa:bb:33:dd:ee:ff`.
--Gränssnitt Eller --interface-name [Retiring]	Sträng	Anger namnet på gränssnittet som ska konfigureras. Kör azsfäriska nätverkslistgränssnitt för enheter för att visa information om nätverksgränssnitten för den anslutna enheten. Argumentet `--interface-name` dras tillbaka och tas bort i en framtida version. Mer information finns i Viktiga ändringar (tillbakadragna funktioner) i Azure Sphere CLI.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10

Återställa

Ersätter systemprogramvaran på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet som kommandot ska köras på när flera enheter är anslutna. Den anslutna enheten används som standard. Ange enhetens ID, IP-adress eller lokala anslutnings-ID.
-c, --capability	Sträng	Anger vilken enhetsfunktionsbild som ska tillämpas på enheten under återställningen.
-i, --bilder	Sträng	Anger sökvägen till en mapp som innehåller avbildningspaketen som ska skrivas till enheten. Som standard används avbildningarna i SDK:et för återställning om inte den här flaggan har en alternativ sökväg.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

Exempel 1:

azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

Exempel 2:

azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

återskanna

Rescans the attached devices by power-cycling all their FTDI ports and displays the total count of attached devices.rescans the attached devices by power-cycling all their FTDI ports and displays the total count of attached devices. Använd det här kommandot när du felsöker problem med enhetsanslutningen i Windows. Det här kommandot körs endast i Windows.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

 azsphere device rescan-attached
 -----------
 Count
 ===========
 2
 -----------

Starta

Startar om den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device restart
Restarting device.
Device restarted successfully.

Visa

Visar information om en ansluten enhet i Azure Sphere-klientorganisationen.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på. Den här parametern krävs när flera enheter är anslutna eller när ingen enhet är ansluten. Den anslutna enheten används som standard. Du kan ange ett enhets-ID för en enhet som inte är ansluten, eller så kan du ange IP-adressen eller lokalt anslutnings-ID för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device show
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Du kan använda parametern --query för att anpassa resultatet som visas för det här kommandot. Mer information finns i Fråge-CLI-kommandoutdata.

I följande exempel visas hur du väljer bara Enhets-ID och Produkt-ID:

azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

visa bifogad

Visar information om den anslutna enheten från själva enheten. Den här informationen skiljer sig från de som Azure Sphere Security Service lagrar för enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143

show-deployment-status

Visar distributionsstatus för program- och operativsystemuppdateringar för enheten.

Använd det här kommandot för att ta reda på vilken version av Azure Sphere-operativsystemet som körs på enheten eller om den aktuella distributionsuppdateringen har slutförts.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.

I det här exemplet <representerar versionsnumret> den aktuella operativsystemversionen.

visa antal

Visar antalet enheter i den aktuella klientorganisationen.

Valfria parametrar

Parametern	Typ	Beskrivning
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

 azsphere device show-count
 ------
 Result
 ======
 2
 ------

show-os-version

Visar den aktuella operativsystemversionen på den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>

I det här exemplet <representerar versionsnumret> den aktuella operativsystemversionen.

separat inläsning

Hanterar programmet på enheten.

Vissa alternativ för separat inläsning kräver ytterligare funktioner när enheten är i tillverkningstillståndet DeviceComplete. Med funktionen fieldServicing kan du distribuera och ta bort tillfälliga produktionssignerade avbildningar och distribuera permanenta produktionssignerade avbildningar. Med funktionen appUtveckling kan du distribuera och ta bort både produktionssignerade och SDK-signerade avbildningar.

Drift	Beskrivning
Ta bort	Tar bort det aktuella programmet från enheten.
Distribuera	Läser in ett program på enheten.
set-deployment-timeout	Anger tidsgränsperioden för distributionen i sekunder.
visa-distribution-timeout	Visar tidsgränsperioden för distributionen i sekunder.

Observera att parametrarna till start, stop, show-statusoch show-quota har flyttats till azsfärenhetsappkommandot .

ta bort separat inläsning

Tar bort program från enheten.

Det här kommandot är bara tillgängligt om funktionen appUtvecklingsenhet är konfigurerad.

Valfria parametrar

Parametern	Typ	Beskrivning
-i, --component-id	GUID	Anger ID för programmet som ska tas bort från enheten. Om det utelämnas tas alla program bort.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.

distribuera separat inläsning

Läser in ett program på den anslutna enheten och startar programmet.

Det här kommandot misslyckas om programmanifestet begär en resurs som används av ett program som redan finns på enheten. I det här fallet använder du borttagning av azsfärenhet separat inläsning för att ta bort det befintliga programmet och försöker sedan läsa in separat igen. Borttagningskommandot för azsfärenhet vid separat inläsning tar bort både program på hög nivå och program i realtid. Om du vill ta bort ett program och lämna det andra anger du det komponent-ID som ska tas bort i programmet.

Samma kommando används för att distribuera både högnivåprogram och realtidsstödprogram.

Observera

En omstart av enheten utlöses när ett nytt program som använder kringutrustning installeras och följande villkor uppfylls:

Enhetens tillverkningsstatus är inställd på DeviceComplete.
AppUtvecklingsfunktionen finns inte på enheten. Mer information finns i Låsning av kringutrustningskonfiguration.

Om en enhetsomstart initieras väntar du tills omstarten är klar och enheten svarar.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-p, --image-package	Sträng	Anger sökvägen och filnamnet för avbildningspaketet som ska läsas in på enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-m, --manual-start	Boolean	Anger att programmet inte ska startas automatiskt när det har laddats in.
--Kraft	Boolean	Tvingar fram distributionen av en avbildning som använder ett Beta-API som kanske inte längre stöds.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.

timeout för separat inläsning av set-deployment

Anger tidsgränsvärdet för distributionen i sekunder för separat inläsning av avbildningar på enheten.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-v, --value	Heltal	Anger varaktigheten i sekunder innan ett separat inläsningskommando släcks. Värdet måste vara ett positivt heltal.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device sideload set-deployment-timeout --value 60
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

separat inläsning av timeout för show-deployment

Visar det aktuella time out-värdet för distribution i sekunder för separat inläsning av avbildningar på enheten.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device sideload show-deployment-timeout
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

Uppdatering

Flyttar enheten till en annan enhetsgrupp i Azure Sphere-klienten.

Utöver de enhetsgrupper du skapar i en produkt läggs fem standardenhetsgrupper till när en produkt skapas:

Utveckling: Accepterar endast uppdateringar av systemprogramvara. Accepterar inte programuppdateringar.
Fälttest: Accepterar alla uppdateringar från Azure Sphere-säkerhetstjänsten.
Produktion: Accepterar alla uppdateringar från Azure Sphere-säkerhetstjänsten.
Utvärdering av produktionsoperativsystem: Accepterar alla uppdateringar från Azure Sphere-säkerhetstjänsten.
Utvärdering av fälttestoperativsystem: Accepterar alla uppdateringar från Azure Sphere-säkerhetstjänsten.

Mer information om grundläggande element som ingår i distributionen finns i Grunderna i distribution.

Valfria parametrar

Parametern	Typ	Beskrivning
-g, --device-group	GUID eller namn	Anger den enhetsgrupp som enheten ska flyttas i. Du kan ange enhetsgrupp-ID eller enhetsgruppnamn. Om du vill använda enhetsgruppens namn måste du ange både produktnamnet och enhetsgruppens `<product-name/device-group-name>` namn i formatet.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på. Den här parametern krävs när flera enheter är anslutna eller när ingen enhet är ansluten. Den anslutna enheten används som standard. Du kan ange ett enhets-ID för en enhet som inte är ansluten, eller så kan du ange IP-adressen eller lokalt anslutnings-ID för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
-t, --tenant	GUID eller namn	Anger vilken klientorganisation som den här åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientorganisationsnamn.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device update --device-group AW100/Marketing
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                               TenantId                             ChipSku  ProductId                            DeviceGroupId
 ==============================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 427D205E46A166B7E41135EB968
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------

Du kan använda parametern --query för att anpassa resultatet som visas för det här kommandot. Mer information finns i Fråge-CLI-kommandoutdata.

I följande exempel visas hur du väljer bara Enhets-ID och Produkt-ID:

azsphere device update --device-group AW100/Marketing  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Wifi

Hanterar Wi-Fi konfigurationer för den anslutna enheten.

Om du vill använda enheten i ett Wi-Fi nätverk måste du lägga till information om nätverket och aktivera nätverket på enheten. Även om du kan mata in icke-ASCII-tecken i SSSID:er visas de inte korrekt i azsfären .

Om programmet använder WI-Fi-konfigurations-API:et måste du även inkludera WifiConfig-funktionen i programmets app_manifest.json-fil .

Drift	Beskrivning
Add	Lägger till information om ett trådlöst nätverk på enheten.
Inaktivera	Inaktiverar ett trådlöst nätverk på enheten.
Aktivera	Aktiverar ett trådlöst nätverk på enheten.
Glömma	Tar bort information om ett trådlöst nätverk från enheten.
Lista	Listor den aktuella Wi-Fi konfigurationen för enheten.
läs in-config igen	Laddar om enheten Wi-Fi konfiguration.
Scan	Söker efter tillgängliga nätverk.
Visa	Visar information om en Wi-Fi konfiguration.
visa-status	Visar status för det trådlösa gränssnittet.

wifi lägg till

Lägger till information om ett Wi-Fi nätverk på den anslutna enheten.

En enhet kan ha flera Wi-Fi anslutningar. Även om du kan mata in icke-ASCII-tecken i SSSID:er visas de inte korrekt i azsfären . Du kan ta med parametern --targeted-scan för att ansluta till dolda SSD:n. Mer information finns i Ansluta Azure Sphere till Wi-Fi.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-s, --ssid	Sträng	Anger nätverkets SSID. Nätverks-SSD:n är skiftlägeskänsliga.

Valfria parametrar

Parametern	Typ	Beskrivning
--client-cert-id	Sträng	[EAP-TLS] Anger identifieraren (upp till 16 tecken) som identifierar klientcertifikatet (som innehåller både den offentliga och den privata nyckeln). Krävs för att konfigurera ett EAP-TLS-nätverk.
--klient-id <user@domain>	Sträng	[EAP-TLS] Anger det ID som kan identifieras för autentisering av nätverkets RADIUS-server. Krävs för vissa EAP-TLS-nätverk.
--config-name	Sträng	Anger en sträng (upp till 16 tecken) som anger namnet på nätverkskonfigurationen.
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.
--root-ca-cert-id	Sträng	[EAP-tLS] Anger identifieraren (upp till 16 tecken) som identifierar serverns rotcertifikat för certifikatutfärdare för EAP-TLS-nätverk där enheten autentiserar servern.
--targeted-scan	Boolean	Försöker ansluta till ett nätverk även när det inte sänder eller döljs av överbelastning i nätverket.
-p, --psk	Sträng	Anger WPA/WPA2-nyckeln för det nya nätverket. Utelämna att lägga till SSID som ett öppet nätverk. Om nyckeln innehåller ett et-tecken (&) omger du nyckeln med citattecken.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 1     MyNetwork enabled            unknown         psk           False
 ----- -------- ------------------ --------------- ------------- ------------

Om nätverkets SSID eller nyckel har inbäddade blanksteg eller ett et-tecken omger du SSID eller tangenten med enkla citattecken. Om SSID eller nyckel innehåller ett citattecken kan du använda ett omvänt snedstreck för att komma ur citattecknet. Omvänt snedstreck behöver inte vara undantagna om de är en del av ett värde. Mer information finns i Citattecken och undantagstecken. Till exempel:

azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

wifi disable

Inaktiverar ett Wi-Fi nätverk på den anslutna enheten.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-i, --id	Heltal	Anger ID för nätverket som ska inaktiveras.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0     MyNetwork disabled           disconnected    psk           False
----- -------- ------------------ --------------- ------------- ------------

wifi enable

Aktiverar ett Wi-Fi nätverk på den anslutna enheten.

Om du vill byta från ett nätverk till ett annat om båda är inom räckhåll inaktiverar du det anslutna nätverket innan du aktiverar det nya nätverket.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-i, --id	Heltal	Anger nätverkets ID som ska aktiveras.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi enable --id 0
Successfully enabled network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- -------- ------------------ --------------- ------------- ------------

wifi glöm

Tar bort information om ett Wi-Fi nätverk från den anslutna enheten.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-i, --id	Heltal	Anger nätverkets ID som ska tas bort.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi forget --id 0
Successfully forgotten network.

wifi-lista

Listor den aktuella Wi-Fi konfigurationen för den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi list
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork1 enabled            connected       psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 1     MyNetwork2 enabled            disconnected    psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 2     MyNetwork3 enabled            disconnected    eaptls        False
 ----- ---------  ------------------ --------------- ------------- ------------

wifi reload-config

Läser in konfigurationen Wi-Fi nätverk igen på den anslutna enheten. Använd det här kommandot när du har lagt till eller ta bort ett certifikat (azsfärenhetscertifikat) för att säkerställa att EAP-TLS-nätverk använder det senaste innehållet i certifikatarkivet.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.

wifi scan

Sök efter tillgängliga Wi-Fi nätverk som är synliga för den anslutna enheten. Kommandot returnerar upp till 64 Wi-Fi nätverk, men antalet Wi-Fi nätverk som visas kan begränsas av miljöfaktorer som tätheten av åtkomstpunkter i intervall.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID              SecurityState BSSID             SignalLevel Frequency
=======================================================================
MyNetwork0        psk           <value>           -66         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1        psk           <value>           -75         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2        psk           <value>           -86         2412
----------------- ------------- ----------------- ----------- ---------

wifi show

Visar information om ett Wi-Fi nätverk på den anslutna enheten.

Obligatoriska parametrar

Parametern	Typ	Beskrivning
-i, --id	Heltal	Anger ID för nätverkskonfigurationen som ska visas.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device wifi show --id 0
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- --------- ------------------ --------------- ------------- ------------

wifi show-status

Visar status för Wi-Fi-gränssnittet på den anslutna enheten.

Valfria parametrar

Parametern	Typ	Beskrivning
-d, --device	Sträng	Anger vilken enhet kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget på Linux. Av den anledningen stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux.

Globala parametrar

Följande globala parametrar är tillgängliga för Azure Sphere CLI:

Parametern	Beskrivning
--Debug	Ökar utförligheten för loggning för att visa alla felsökningsloggar. Om du hittar ett fel anger du utdata som genereras med `--debug` flaggan på när du skickar en felrapport.
-h, --help	Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon.
--only-show-errors	Visar endast fel och ignorerar varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (färgat JSON), tsv (tabbavgränsade värden), tabell (läsbara ASCII-tabeller) och yaml. Som standard utdata `table`från CLI . Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--Fråga	Använder frågespråket JMESPath för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i självstudiekursen om JMESPath och Fråga Azure CLI-kommandoutdata .
--Utförlig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Används `--debug` för fullständiga felsökningsloggar.

Observera

Om du använder azure sphere klassiska CLI, se Globala parametrar för mer information om tillgängliga alternativ.

Exempel

 azsphere device wifi show-status
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
 SSID  ConfigurationState ConnectionState SecurityState Frequency Mode    KeyManagement WpaState  IpAddress     MacAddress
 ================================================================================================================================
<value> enabled            connected       psk           2412      station WPA2-PSK      COMPLETED <value>      <value>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------

Dela via

Enhet

App

app show-memory-stats

Valfria parametrar

Exempel

visa-kvot för app

Valfria parametrar

Exempel

app show-status

Valfria parametrar

Exempel

appstart

Valfria parametrar

Exempel

appstopp

Valfria parametrar

Exempel

Kapacitet

funktionsnedladdning

Obligatoriska parametrar

Valfria parametrar

Exempel

funktion välj

Valfria parametrar

Exempel

funktionsvisningsansluten

Valfria parametrar

Exempel

funktionsuppdatering

Obligatoriska parametrar

Valfria parametrar

Exempel

Certifikat

certifikattillägg

Obligatoriska parametrar

Valfria parametrar

Exempel

ta bort certifikat

Obligatoriska parametrar

Valfria parametrar

Exempel

certifikatlista

Valfria parametrar

Exempel

certifikatvisning

Obligatoriska parametrar

Valfria parametrar

Exempel

visningskvot för certifikat

Valfria parametrar

Exempel

Hävdar

Valfria parametrar

Exempel

enable-cloud-test

Valfria parametrar

Exempel

aktivera-utveckling

Valfria parametrar

Exempel

Bild

avbildningslista installerad

Valfria parametrar

Exempel

bildlista riktad

Valfria parametrar

Exempel

Lista

Valfria parametrar

Exempel

bifogad lista

Exempel

tillverkningstillstånd

tillverkningsstatusvisning

Valfria parametrar

Exempel

tillverkningstillståndsuppdatering

Obligatoriska parametrar

Valfria parametrar