enhet

Artikel
09/27/2024

Viktigt!

Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).

Hanterar Azure Sphere-enheter.

Operation	beskrivning
app	Ändrar status för program på en enhet.
förmåga	Hanterar enhetsfunktioner.
intyg	Hanterar enhetscertifikatarkivet.
anspråk	Gör anspråk på en tidigare oanmäld enhet till Azure Sphere-klientorganisationen.
enable-cloud-test	Konfigurerar en enhet för att inaktivera felsökning och ta emot uppdateringar.
enable-development	Konfigurerar en enhet för lokal felsökning.
bild	Hanterar avbildningar för en enhet.
lista	Visar alla enheter i klientorganisationen.
list-bifogad	Visar en lista över anslutna enheter.
tillverkningstillstånd	Hanterar tillverkningstillståndet för den anslutna enheten.
nätverk	Innehåller information om status för nätverksgränssnitt på enheten.
tillfriskna	Använder särskilt återställningsläge för att läsa in ny inbyggd programvara på enheten.
omskanningsansluten	Söker om anslutna enheter som ett felsökningshjälpmedel (endast Windows).
starta om	Startar om den anslutna enheten.
visa	Visar information om enhetens uppdateringskonfiguration.
show-attached	Visar information om den anslutna enheten från själva enheten.
show-count	Visar det totala antalet enheter i en klientorganisation.
show-deployment-status	Visar status för den senaste distributionsuppdateringen.
show-os-version	Visar den lokala enhetsoperativsystemets version.
separat inläsning	Läser in en bild på den anslutna enheten.
uppdatera	Uppdaterar en enhet genom att placera den i en specifik enhetsgrupp.
wifi	Hanterar Wi-Fi-konfigurationen för enheten.

-program

Hanterar program på enheten.

Många av appalternativen kräver funktionen appUtveckling, som kan hämtas med hjälp av azsphere device enable-development. 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 azsphere device app stop och azsphere device app start för att starta om ett realtidskompatibelt program för att avgöra vilken realtidskärna den körs på.

Operation	beskrivning
show-memory-stats	Visar minnesstatistiken för program på den anslutna enheten.
show-quota	Visar mängden lagringsutrymme som används av det aktuella programmet på enheten.
show-status	Returnerar status för det aktuella programmet på enheten.
start	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 endast tillgängligt om funktionen appUtvecklingsenhet har konfigurerats. Ytterligare information visas om spårning av heapminnesallokering har konfigurerats.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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
 -------------- -------------

app show-quota

Visar mängden föränderligt lagringsutrymme som allokerats och används på den anslutna enheten.

Du anger den föränderliga lagringskvoten i programmanifestet och Azure Sphere OS tillämpar kvoter när det allokerar sektorer för filen. Om du minskar MutableStorage värdet ändras därför inte mängden lagringsutrymme som används, men det allokerade värdet kommer att vara annorlunda. 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

Parameter	Typ	Beskrivning
-i, --component-id	GUID	Anger ID:t för komponenten som du vill hämta kvotinformation för. Om det utelämnas visas kvotinformation för alla komponenter.
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-i, --component-id	GUID	Anger ID för komponenten som status ska visas för. Om det utelämnas visar status för alla komponenter.
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
--debug-mode	Booleskt	Startar programmet för felsökning. Måste `--component-id` anges.
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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 det utelämnas startar alla program.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-i, --component-id	GUID	Anger ID för komponenten som ska stoppas. Om det utelämnas stoppas alla program.
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

förmåga

Hanterar enhetsfunktioner. Enhetsfunktioner 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 azsphere device capability download . Du kan använda konfiguration av enhetsfunktioner på den anslutna Azure Sphere-enheten med kommandot azsphere device capability update och du kan skapa en servicesession med kommandot azsphere device capability select. Mer information om enhetsfunktioner finns i Enhetsfunktioner och kommunikation.

Operation	beskrivning
download	Laddar ned en konfiguration av enhetsfunktioner från Azure Sphere Security Service.
utvald	Väljer en nedladdad kapacitetsfil som ska användas för en servicesession.
show-attached	Visar kapacitetskonfigurationen för den anslutna enheten.
uppdatera	Tillämpar en enhetsfunktionskonfiguration på den anslutna enheten.

funktionsnedladdning

Laddar ned en enhetsfunktion från Azure Sphere Security Service.

Med funktionen appDevelopment kan du läsa in SDK-signerade program separat och starta, stoppa, felsöka eller ta bort program på enheten. Utan funktionen appUtveckling kan endast molninlästa program läsas in och starta, stoppa, felsöka och ta bort är förbjudna. Funktionen appDevelopment används som en del av kommandot azsphere device enable-development.

Om du laddar ned funktionen fieldServicing resulterar det i en fil som innehåller funktionen för en enda Azure Sphere-enhet. Kapacitetsfilen fieldServicing laddas ned till den lokala datorn och kan användas tillsammans med kommandot azsphere device capability select.

Obligatoriska parametrar

Parameter	Typ	Beskrivning
--typ	Kapacitetstyp	Anger vilken typ av enhetskapacitet som ska laddas ned. Värden är appUtveckling, fieldServicing eller ingen. Använd ingen för att ta bort funktionen appUtveckling eller funktionen fieldServicing .

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 oansluten enhet eller ange IP-adressen eller det lokala anslutnings-ID:t för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför 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	String	Anger sökvägen och filnamnet där kapacitetskonfigurationen ska sparas. Inkludera en absolut eller relativ sökväg. Om du inte anger någon sökväg lagrar kommandot filen i den lokala katalogen med hjälp av namngivningskonventionens kapacitetstyp>, de första åtta tecknen i enhets-ID.cap><.<
-t, --tenant	GUID eller namn	Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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
 --------------------------------------------

funktionsval

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

Kommandot azsphere device capability select kan användas med alla funktioner, men används oftast med funktionen fieldServicing för att aktivera en servicesession. Alla användarroller har åtkomst till kommandot azsphere device capability select .

När du använder funktionen fieldServicing aktiveras kommunikationen mellan Azure Sphere-enheten och den lokala datorn som innehåller kapacitetsfilen. Kapacitetsfilen 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 servicesession använder du azsphere device capability select --none.

Valfria parametrar

Parameter	Typ	Beskrivning
--capability-file	String	Anger sökvägen och filnamnet till konfigurationsfilen för enhetsfunktioner som ska väljas. Du kan ange en relativ eller absolut sökväg.
-n, --none	-	Rensar alla tidigare valda enhetsfunktionskonfigurationer.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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.

funktionen show-attached

Visar kapacitetskonfigurationen som lagras på den anslutna enheten.

Kommentar

Kommandot visar de funktioner som konfigurerats med hjälp av en funktionsfil och vissa, men inte alla, funktioner som finns som standard på tavlor.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
--capability-file	String	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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 oansluten enhet eller ange IP-adressen eller det lokala anslutnings-ID:t för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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.

Operation	beskrivning
addera	Lägger till ett certifikat i certifikatarkivet på den anslutna enheten.
ta bort	Tar bort ett certifikat från den anslutna enhetens certifikatarkiv.
lista	Visar en lista över de certifikat-ID:n som är tillgängliga i den anslutna enhetens certifikatarkiv.
visa	Visar information om ett certifikat i den anslutna enhetens certifikatarkiv.
show-quota	Visar tillgängligt ledigt utrymme i den anslutna enhetens certifikatarkiv.

lägg till certifikat

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

Rotcertifikatutfärdaren och klientcertifikaten 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 rätt 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 ditt EAP-TLS-nätverk. Nätverksadministratören eller säkerhetsteamet kan ange den information du behöver för att hämta certifikaten. Mer information om hur du hämtar rotcertifikatutfärdarcertifikatet finns i Hämta och distribuera certifikat för EAP-TLS-nätverk.

Varning

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

Mer information finns i Certifikat-ID :t.

Obligatoriska parametrar

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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	String	Anger sökvägen till en .pem-fil för certifikat för en privat klientnyckel. Krävs när du lägger till ett certifikat av typen klient. Du kan ange en relativ eller absolut sökväg.
-w, --private-key-password	String	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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 anslutna enhetens certifikatarkiv.

Obligatoriska parametrar

Parameter	Typ	Beskrivning
-c, --certificate eller --cert-id [Pensionering]	String	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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

azsphere device certificate delete --certificate certclient

certifikatlista

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-c, --certificate eller --cert-id [Pensionering]	String	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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

certifikat show-quota

Visar tillgängligt ledigt utrymme i den anslutna enhetens certifikatarkiv.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

anspråk

Gör anspråk på en tidigare oanmäld enhet 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 en enhet har begärts kan den inte flyttas till en annan klientorganisation.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 oansluten enhet eller ange IP-adressen eller det lokala anslutnings-ID:t för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför 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 den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.
--kraft	Booleskt	Tvingar en enhet att begäras i den aktuella användarens valda Azure Sphere-klientorganisation.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 den anslutna enheten för att testa molninläsning genom att inaktivera programutveckling, ta bort befintliga program och aktivera molninlästa programuppdateringar.

Det kräver att en enhet ansluts till datorn och endast fungerar på den anslutna enheten.

Mer specifikt, enable-cloud-test:

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

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

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

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

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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älttestenhet för den här produkten, såvida inte `--device-group` också anges. Du kan ange antingen ID:t eller namnet på Azure Sphere-produkten.
-t, --tenant	GUID eller namn	Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.
-g, --device-group	GUID eller namn	Anger den enhetsgrupp som enheten ska flyttas till. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. 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 detta produktgruppen Fälttestenhet.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

Det här exemplet tilldelar 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 den enhetsgrupp 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 aktiverar molninläsning och tilldelar enheten till en produkt efter namn.

azsphere device enable-cloud-test --product DW100

enable-development

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, aktivera utveckling:

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

Om du kör kommandot azsphere device enable-development utan parametrar:

Om enheten inte redan har en produkt- eller enhetsgrupp laddar kommandot ned och tillämpar funktionen appUtveckling 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å enheten och snabbstarten för att skapa ett högnivåprogram påverkas inte.
Om enheten redan har en produkt flyttar kommandot enheten till produktens enhetsgrupp Utveckling . Som standard inaktiveras programuppdateringar för den här gruppen, vilket säkerställer att separat inlästa appar inte skrivs över.

Om du kör kommandot azsphere device enable-development med parametern --product :

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

Om du kör kommandot azsphere device enable-development med parametern --device-group :

Placerar enheten i den angivna enhetsgruppen har angetts. Målenhetsgruppen får inte aktivera programuppdateringar eller så returneras ett fel.

I vissa fall rapporterar azsphere device enable-development 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 azsphere tenant show-selected för att se till att du är inloggad på den klientorganisation där du begärde enheten. Om inte använder du azsphere-inloggning 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 azsphere-enhetsanspråket för att göra anspråk på enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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 enhetsgrupps-ID eller enhetsgruppsnamn. 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-debugging	Booleskt	Installerar drivrutiner som krävs för att felsöka program som körs i en realtidskärna. 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 Utvecklingsenhet för den här produkten, såvida inte `--device-group` också anges. Du kan ange antingen ID:t eller namnet på Azure Sphere-produkten.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 de avbildningar som är installerade på eller riktade till den anslutna enheten.

Operation	beskrivning
list-installerat	Innehåller information om de avbildningar som för närvarande är installerade på den anslutna enheten.
list-targeted	Innehåller information om de bilder som är riktade till den anslutna enheten.

image list-installed

Visar en lista över de avbildningar som är installerade på den anslutna enheten. Listan med information innehåller komponent- och bild-ID:t.

Kommentar

Långa bildnamn trunkeras med 31 tecken.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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	Booleskt	Visar en lista över alla programvarubilder som är installerade på enheten. Som standard visas endast programbilder, felsökningsprogram och bildkortkonfigurationsbilder.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

image list-targeted

Visar en lista över avbildningar som har laddats upp till Azure Sphere Security Service 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 oansluten enhet eller ange IP-adressen eller det lokala anslutnings-ID:t för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför 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 den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.
-f, --full	Booleskt	Visar en lista över alla avbildningar i din Azure Sphere-klientorganisation.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Visar en lista över alla enheter i en klientorganisation. Listan trunkerar efter de första 500 enheterna.

Valfria parametrar

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

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 utdata som visas för det här kommandot. Mer information finns i Fråga CLI-kommandoutdata.

I följande exempel visas hur du bara väljer 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
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Dricks

Kör azsphere-produktprogrammet --product <product-ID> för att visa produktnamnet eller azsphere device-group show --device-group <devicegroup-ID> för att visa enhetsgruppens namn.

list-bifogad

Visar en lista över de enheter som är anslutna till den lokala datorn.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 tillverkningstillståndet för den anslutna enheten.

Operation	beskrivning
visa	Visar tillverkningstillståndet för den anslutna enheten.
uppdatera	Uppdaterar tillverkningstillståndet för den anslutna enheten.

Varning

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

tillverkningstillståndsvisning

Visar tillverkningstillståndet för den anslutna enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

uppdatering av tillverkningstillstånd

Uppdaterar tillverkningstillståndet för den anslutna enheten. Mer information finns i Ange enhetens tillverkningstillstånd.

Varning

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

Obligatoriska parametrar

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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.

network

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

Operation	beskrivning
möjliggöra	Aktiverar ett nätverksgränssnitt på den anslutna enheten.
inaktivera	Inaktiverar ett nätverksgränssnitt på den anslutna enheten.
list-firewall-rules	Visar en lista över brandväggsreglerna för den anslutna enheten.
list-interfaces	Visar en lista över nätverksgränssnitten för den anslutna enheten.
proxyserver	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.
show-status	Visar nätverksstatus för den anslutna enheten.
update-interface	Uppdaterar en nätverksgränssnittskonfiguration för enheten.

nätverksaktivering

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

Kommentar

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

Parameter	Typ	Beskrivning
--gränssnitt	sträng	Anger vilket gränssnitt som ska aktiveras.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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.

Kommentar

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

Parameter	Typ	Beskrivning
--gränssnitt	sträng	Anger vilket gränssnitt som ska aktiveras.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Visar en lista över brandväggsreglerna för den anslutna enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Namn på brandväggsregleruppsättning: Visar namnet på brandväggsregeluppsättningsblocket.
- Värdena är PREROUTING, POSTROUTING, INPUT, FORWARD och OUTPUT.
Är regeluppsättningen giltig: Visar status för regeluppsättningen. Värdena är True eller False.
Regler för brandväggsregler: Visar värdena för följande regler:
- Käll-IP: Visar IP-adressen för den sändande datorn.
- Källmask: Visar nätverksmasken för den sändande 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.
- Gränssnittets IN-namn: Visar namnet på indatagränssnittet. Till exempel wlan0.
- Gränssnitts-OUT-namn: Visar utdatagränssnittets namn. 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: Booleskt värde anger att känslan av TCP-flaggorna ska inverteras. Värdena är True eller False.
- Protokoll: Visar protokollet för brandväggsregeln. 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: Brådskande pekarfält betydande
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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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ätverkslistegränssnitt

Visar en lista över nätverksgränssnitten för den anslutna enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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.

Kommentar

För närvarande stöds endast HTTP-proxyservrar.

Operation	beskrivning
proxy apply	Konfigurerar nätverksproxyn på den anslutna enheten.
proxyborttagning	Tar bort proxyanslutningen på den anslutna enheten.
proxyvisning	Visar proxyanslutning på den anslutna enheten.

proxy apply

Konfigurerar nätverksproxyn på den anslutna enheten.

Obligatoriska parametrar

Parameter	Typ	Beskrivning
-a, --address	String	Anger nätverksadressen för proxyn som ska användas.
-t, --authentication	String	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 detta till `basic`, annars använder du `anonymous`.
-r, --port	Integer	Anger porten på den nätverksadress som ska användas. Värdet måste vara lika med eller mindre än 65535.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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öjliggöra	String	Anger om proxyn ska vara aktiverad. Du måste ange antingen `--enable` eller `--disable`.
--inaktivera	String	Anger om proxyn ska inaktiveras. Du måste ange antingen `--enable` eller `--disable`.
-n, --no-proxy-addresses	String	Anger en matris med utrymmesavgränsade nätverksadresser som enheten ska undvika för proxyanslutning.
-p, --password	String	Anger lösenordet för proxyautentisering Som endast används för grundläggande autentisering. Maximal längd: 64 tecken.
-u, --username	String	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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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	Integer	Anger ID för Wi-Fi-nätverket för vilket diagnostik ska visas.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

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

Kommentar

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

Parameter	Typ	Beskrivning
--hardware-address	String	Anger maskinvaruadressen som ska anges 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]	String	Anger namnet på gränssnittet som ska konfigureras. Kör azsphere device network list-interfaces 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

recover

Ersätter systemprogramvaran på enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	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	String	Anger den enhetsfunktionsbild som ska tillämpas på enheten under återställningen.
-i, --images	String	Anger sökvägen till en mapp som innehåller de avbildningspaket som ska skrivas till enheten. Som standard använder återställning bilderna i SDK såvida inte en alternativ sökväg tillhandahålls med den här flaggan.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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.

omskanningsansluten

Genomsöker de anslutna enheterna genom att strömcykla alla sina FTDI-portar och visar det totala antalet anslutna enheter. Använd det här kommandot när du felsöker problem med enhetsanslutning 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

restart

Startar om den anslutna enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 din Azure Sphere-klientorganisation.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 oansluten enhet eller ange IP-adressen eller det lokala anslutnings-ID:t för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför 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 den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 utdata som visas för det här kommandot. Mer information finns i Fråga CLI-kommandoutdata.

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

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

show-attached

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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 enheten kör eller om den aktuella distributionsuppdateringen har slutförts.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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 den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 versionen av operativsystemet.

show-count

Visar antalet enheter i den aktuella klientorganisationen.

Valfria parametrar

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

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

show-os-version

Visar den aktuella versionen av operativsystemet på den anslutna enheten.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 versionen av operativsystemet.

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 appDevelopment kan du distribuera och ta bort både produktionssignerade och SDK-signerade avbildningar.

Operation	beskrivning
ta bort	Tar bort det aktuella programmet från enheten.
gruppera	Läser in ett program på enheten.
set-deployment-timeout	Anger tidsgränsen för distributionen i sekunder.
show-deployment-timeout	Visar tidsgränsen för distributionen i sekunder.

Observera att parametrarna till start, stop, show-statusoch show-quota har flyttats till kommandot azsphere device app .

ta bort separat inläsning

Tar bort program från enheten.

Det här kommandot är endast tillgängligt om funktionen appUtvecklingsenhet har konfigurerats.

Valfria parametrar

Parameter	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	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

separat inläsningsdistribution

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 azsphere device sideload delete för att ta bort det befintliga programmet och försöker sedan läsa in igen. Kommandot azsphere device sideload delete tar bort både högnivåprogram och realtidsprogram. Om du vill ta bort ett program och lämna det andra anger du det komponent-ID för programmet som ska tas bort.

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

Kommentar

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

Enhetens tillverkningstillstånd är inställt på DeviceComplete.
Funktionen appDevelopment finns inte på enheten. Mer information finns i Låsning av kringutrustningskonfiguration.

Om en omstart av enheten initieras väntar du tills omstarten är klar och enheten blir responsiv.

Obligatoriska parametrar

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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	Booleskt	Anger att programmet inte ska startas automatiskt när det har lästs in.
--kraft	Booleskt	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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 set-deployment-timeout för separat inläsning

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

Obligatoriska parametrar

Parameter	Typ	Beskrivning
-v, --value	Integer	Anger varaktigheten i sekunder innan ett separat inläsningskommando överskrider tidsgränsen. Värdet måste vara ett positivt heltal.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

sideload show-deployment-timeout

Visar det aktuella timeout-värdet för distributionen 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

update

Flyttar enheten till en annan enhetsgrupp i din Azure Sphere-klientorganisation.

Förutom enhetsgrupper som du skapar i en produkt läggs fem standardenhetsgrupper till när en produkt skapas:

Utveckling: Accepterar endast systemprogramuppdateringar. Accepterar inte programuppdateringar.
Fälttest: Accepterar alla uppdateringar från Azure Sphere Security Service.
Produktion: Accepterar alla uppdateringar från Azure Sphere Security Service.
Utvärdering av produktionsoperativsystemet: Accepterar alla uppdateringar från Azure Sphere Security Service.
Utvärdering av fälttest av operativsystem: Accepterar alla uppdateringar från Azure Sphere Security Service.

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

Valfria parametrar

Parameter	Typ	Beskrivning
-g, --device-group	GUID eller namn	Anger den enhetsgrupp där enheten ska flyttas. Du kan ange enhetsgrupps-ID eller enhetsgruppsnamn. 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	String	Anger vilken enhet som 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 oansluten enhet eller ange IP-adressen eller det lokala anslutnings-ID:t för en ansluten enhet. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför 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 den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 utdata som visas för det här kommandot. Mer information finns i Fråga CLI-kommandoutdata.

I följande exempel visas hur du bara väljer 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 SSID:er , visar azsphere inte dem korrekt.

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

Operation	beskrivning
addera	Lägger till information om ett trådlöst nätverk på enheten.
inaktivera	Inaktiverar ett trådlöst nätverk på enheten.
möjliggöra	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	Visar den aktuella Wi-Fi-konfigurationen för enheten.
reload-config	Laddar om enhetens Wi-Fi-konfiguration.
avsöka	Söker efter tillgängliga nätverk.
visa	Visar information om en Wi-Fi-konfiguration.
show-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 SSID:er , visar azsphere inte dem korrekt. Du kan inkludera parametern --targeted-scan för att ansluta till dolda SSID:er. Mer information finns i Ansluta Azure Sphere till Wi-Fi.

Obligatoriska parametrar

Parameter	Typ	Beskrivning
-s, --ssid	String	Anger SSID för nätverket. Nätverks-SSID:er är skiftlägeskänsliga.

Valfria parametrar

Parameter	Typ	Beskrivning
--client-cert-id	String	[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.
--client-id <user@domain>	String	[EAP-TLS] Anger det ID som identifieras för autentisering av nätverkets RADIUS-server. Krävs för vissa EAP-TLS-nätverk.
--config-name	String	Anger en sträng (upp till 16 tecken) som anger namnet på nätverkskonfigurationen.
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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	String	[EAP-tLS] Anger identifieraren (upp till 16 tecken) som identifierar serverns rotcertifikatutfärdarcertifikat för EAP-TLS-nätverk där enheten autentiserar servern.
--targeted-scan	Booleskt	Försöker ansluta till ett nätverk även om det inte sänder eller döljs av nätverksbelastning.
-p, --psk	String	Anger WPA/WPA2-nyckeln för det nya nätverket. Utelämna för att lägga till SSID som ett öppet nätverk. Om nyckeln innehåller ett et-tecken (&) omger du nyckeln inom citattecken.

Globala parametrar

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

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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:t eller nyckeln med enkla citattecken. Om SSID eller nyckel innehåller ett citattecken använder du ett omvänt snedstreck för att undvika 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 inaktivera

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

Obligatoriska parametrar

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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-aktivera

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 intervallet inaktiverar du det anslutna nätverket innan du aktiverar det nya nätverket.

Obligatoriska parametrar

Parameter	Typ	Beskrivning
-i, --id	Integer	Anger ID för nätverket som ska aktiveras.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-i, --id	Integer	Anger ID för nätverket som ska tas bort.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

wifi-lista

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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 Wi-Fi-nätverkskonfigurationen igen på den anslutna enheten. Använd det här kommandot när du lägger till eller tar bort ett certifikat (azsphere-enhetscertifikat) för att säkerställa att EAP-TLS-nätverk använder det senaste innehållet i certifikatarkivet.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.

Exempel

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

wifi-genomsökning

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 densiteten för åtkomstpunkter i intervallet.

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

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

Valfria parametrar

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

Parameter	Typ	Beskrivning
-d, --device	String	Anger vilken enhet som 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 i Linux. Därför 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:

Parameter	Description
--felsöka	Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan `--debug` 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 undertrycker varningar.
-o, --output	Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut `table`. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon.
--fråga	Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata .
--mångordig	Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra `--debug`.

Kommentar

Om du använder klassiska Azure Sphere CLI kan du läsa 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

-program

app show-memory-stats

Valfria parametrar

Exempel

app show-quota

Valfria parametrar

Exempel

app show-status

Valfria parametrar

Exempel

appstart

Valfria parametrar

Exempel

appstopp

Valfria parametrar

Exempel

förmåga

funktionsnedladdning

Obligatoriska parametrar

Valfria parametrar

Exempel

funktionsval

Valfria parametrar

Exempel

funktionen show-attached

Valfria parametrar

Exempel

funktionsuppdatering

Obligatoriska parametrar

Valfria parametrar

Exempel

certifikat

lägg till certifikat

Obligatoriska parametrar

Valfria parametrar

Exempel

ta bort certifikat

Obligatoriska parametrar

Valfria parametrar

Exempel

certifikatlista

Valfria parametrar

Exempel

certifikatvisning

Obligatoriska parametrar

Valfria parametrar

Exempel

certifikat show-quota

Valfria parametrar

Exempel

anspråk

Valfria parametrar

Exempel

enable-cloud-test

Valfria parametrar

Exempel

enable-development

Valfria parametrar

Exempel

bild

image list-installed

Valfria parametrar

Exempel

image list-targeted

Valfria parametrar

Exempel

lista

Valfria parametrar

Exempel

list-bifogad

Exempel

tillverkningstillstånd

tillverkningstillståndsvisning

Valfria parametrar

Exempel

uppdatering av tillverkningstillstånd

Obligatoriska parametrar

Valfria parametrar