Apparaat

Beheert Azure Sphere-apparaten.

Bewerking Beschrijving
App Hiermee wijzigt u de status van toepassingen op een apparaat.
Vermogen Hiermee beheert u apparaatmogelijkheden.
Certificaat Hiermee beheert u het certificaatarchief van het apparaat.
Vordering Claimt een eerder niet-geclaimd apparaat naar de Azure Sphere-tenant.
enable-cloud-test Hiermee stelt u een apparaat in om foutopsporing uit te schakelen en updates te ontvangen.
enable-development Hiermee stelt u een apparaat in voor lokale foutopsporing.
Afbeelding Hiermee beheert u installatiekopieën voor een apparaat.
Lijst Geeft alle apparaten in de tenant weer.
list-attached Lijsten de gekoppelde apparaten.
productiestatus Hiermee beheert u de productiestatus van het gekoppelde apparaat.
Netwerk Bevat informatie over de status van netwerkinterfaces op het apparaat.
Herstellen Maakt gebruik van de speciale herstelmodus om nieuwe firmware op het apparaat te laden.
bijgevoegde scan opnieuw Scant gekoppelde apparaten opnieuw als hulp bij het oplossen van problemen (alleen Windows).
Opnieuw starten Start het gekoppelde apparaat opnieuw op.
Toon Geeft details weer over de updateconfiguratie van het apparaat.
show-attached Geeft details weer over het gekoppelde apparaat van het apparaat zelf.
show-count Toont het totale aantal apparaten in een tenant.
show-deployment-status Geeft de status van de meest recente implementatie-update weer.
show-os-version Geeft de versie van het besturingssysteem van het lokale apparaat weer.
sideloaden Laadt een afbeelding op het gekoppelde apparaat.
Update Updates een apparaat door het in een specifieke apparaatgroep te plaatsen.
Wifi Hiermee beheert u de Wi-Fi configuratie voor het apparaat.

App

Hiermee beheert u toepassingen op het apparaat.

Voor veel van de app-opties is de appDevelopment-mogelijkheid vereist, die kan worden verkregen met behulp van azsphere device enable-development. Als u een sdk-ondertekende toepassing of een door de productie ondertekende toepassing wilt starten, stoppen of fouten wilt opsporen, moet het apparaat de appDevelopment-mogelijkheid hebben.

U kunt azsphere device app stop en azsphere device app start gebruiken om een actieve realtime toepassing opnieuw te starten om te bepalen op welke realtime kern deze wordt uitgevoerd.

Bewerking Beschrijving
show-memory-stats Geeft de geheugenstatistieken voor toepassingen op het gekoppelde apparaat weer.
show-quota Geeft de hoeveelheid opslagruimte weer die door de huidige toepassing op het apparaat wordt gebruikt.
show-status Retourneert de status van de huidige toepassing op het apparaat.
Start Hiermee start u de toepassing die op het apparaat is geladen.
Stoppen Stopt de toepassing die wordt uitgevoerd op het apparaat.

app show-memory-stats

Toont de geheugenstatistieken voor toepassingen op het gekoppelde apparaat. Deze opdracht is alleen beschikbaar als de appDevelopment-apparaatmogelijkheid is geconfigureerd. Er wordt aanvullende informatie weergegeven als het bijhouden van heap-geheugentoewijzing is geconfigureerd.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

app show-quotum

Geeft de hoeveelheid onveranderbare opslag weer die is toegewezen en wordt gebruikt op het gekoppelde apparaat.

U stelt het muteerbare opslagquotum in het toepassingsmanifest in en het Azure Sphere-besturingssysteem dwingt quota af wanneer sectoren voor het bestand worden toegewezen. Als u de MutableStorage waarde verlaagt, verandert de hoeveelheid opslagruimte in gebruik niet, maar is de gerapporteerde toegewezen waarde anders. Als de toepassing bijvoorbeeld al 16 kB heeft gebruikt en u de MutableStorage waarde wijzigt in 8 kB, meldt de opdracht dat de toepassing 16 KB van 8 KB toegewezen gebruikt. De gegevens blijven op het apparaat staan.

Optionele parameters

Parameter Type Beschrijving
-i, --component-id GUID Hiermee geeft u de id van het onderdeel waarvoor quotumgegevens moeten worden opgehaald. Als u dit weglaat, geeft u quotumgegevens weer voor alle onderdelen.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

app show-status

Geeft de huidige status van de toepassingen op het apparaat weer.

Optionele parameters

Parameter Type Beschrijving
-i, --component-id GUID Hiermee geeft u de id van het onderdeel waarvoor de status moet worden weergegeven. Als u dit weglaat, wordt de status van alle onderdelen weergegeven.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

app starten

Hiermee start u toepassingen op het apparaat.

Optionele parameters

Parameter Type Beschrijving
--foutopsporingsmodus Booleaanse Hiermee start u de toepassing voor foutopsporing. De --component-id moet worden opgegeven.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-i, --component-id GUID Hiermee geeft u de id van het onderdeel te starten. Als u dit weglaat, worden alle toepassingen gestart.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

app-stop

Stopt de toepassingen op het apparaat.

Optionele parameters

Parameter Type Beschrijving
-i, --component-id GUID Hiermee geeft u de id van het onderdeel dat moet worden gestopt. Als u dit weglaat, stopt u alle toepassingen.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Vermogen

Hiermee beheert u apparaatmogelijkheden. Apparaatmogelijkheden bepalen de bewerkingen die kunnen worden uitgevoerd op een afzonderlijk Azure Sphere-apparaat.

De apparaatmogelijkheden worden gedownload als een bestand van de Azure Sphere-beveiligingsservice met behulp van de opdracht azsphere device capability download . U kunt configuratie van apparaatmogelijkheden toepassen op het gekoppelde Azure Sphere-apparaat met behulp van de opdracht azsphere device capability update en u kunt een onderhoudssessie maken met behulp van de opdracht azsphere device capability select . Zie Apparaatmogelijkheden en communicatie voor meer informatie over apparaatmogelijkheden.

Bewerking Beschrijving
Downloaden Downloadt een configuratie van een apparaatmogelijkheid van de Azure Sphere-beveiligingsservice.
Selecteer Selecteert een gedownload capaciteitsbestand dat moet worden gebruikt voor een onderhoudssessie.
show-attached Geeft de mogelijkheidsconfiguratie voor het gekoppelde apparaat weer.
Update Hiermee past u een configuratie van een apparaatmogelijkheid toe op het gekoppelde apparaat.

mogelijkheid downloaden

Hiermee downloadt u een apparaatmogelijkheid van de Azure Sphere-beveiligingsservice.

Met de appDevelopment-mogelijkheid kunt u door SDK ondertekende toepassingen sideloaden en een toepassing op het apparaat starten, stoppen, fouten opsporen of verwijderen. Zonder de appDevelopment-mogelijkheid kunnen alleen in de cloud geladen toepassingen worden geladen en zijn starten, stoppen, fouten opsporen en verwijderen verboden. De appDevelopment-mogelijkheid wordt toegepast als onderdeel van de opdracht azsphere device enable-development .

Het downloaden van de fieldServicing-mogelijkheid resulteert in een bestand met de mogelijkheid voor één Azure Sphere-apparaat. Het fieldServicing capability-bestand wordt gedownload naar uw lokale computer en kan worden gebruikt in combinatie met de opdracht azsphere device capability select .

Vereiste parameters

Parameter Type Beschrijving
--Type Capaciteitstype Hiermee geeft u het type apparaatmogelijkheid op dat moet worden gedownload. Waarden zijn appDevelopment, fieldServicing of geen. Gebruik geen om de appDevelopment-mogelijkheid of de fieldServicing-mogelijkheid te verwijderen.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld of wanneer er geen apparaat is gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt een apparaat-id opgeven voor een niet-gekoppeld apparaat of u kunt het IP-adres of de lokale verbindings-id van een gekoppeld apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
--Bestemming Tekenreeks Hiermee geeft u het pad en de bestandsnaam op waarop de configuratie van de mogelijkheid moet worden opgeslagen. Neem een absoluut of relatief pad op. Als u geen pad opgeeft, slaat de opdracht het bestand op in de lokale map met behulp van de naamconventiemogelijkheid <type> eerste< acht tekens van device ID.cap>.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

mogelijkheid selecteren

Selecteert een mogelijkheidsbestand voor gebruik met het gekoppelde Azure Sphere-apparaat.

De opdracht azsphere device capability select kan met elke mogelijkheid worden gebruikt, maar wordt meestal gebruikt met de fieldServicing-mogelijkheid om een onderhoudssessie in te schakelen. Elke gebruikersrol heeft toegang tot de opdracht azsphere device capability select .

Wanneer u de fieldServicing-mogelijkheid gebruikt, wordt communicatie ingeschakeld tussen het Azure Sphere-apparaat en de lokale computer die het mogelijkheidsbestand bevat. Het fieldServicing capability-bestand wordt gebruikt voor een sessie tussen de lokale computer en het Azure Sphere-apparaat, en elke opdracht in de sessie wordt voorafgegaan door een bericht dat aangeeft welk capaciteitsbestand in gebruik is.

Als u een onderhoudssessie wilt beëindigen, gebruikt u azsphere device capability select --none.

Optionele parameters

Parameter Type Beschrijving
--capability-file Tekenreeks Hiermee geeft u het pad en de bestandsnaam naar het configuratiebestand van de apparaatmogelijkheid te selecteren. U kunt een relatief of absoluut pad opgeven.
-n, --none - Wist alle eerder geselecteerde configuratie van apparaatfuncties.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

mogelijkheid die is gekoppeld aan show

Geeft de mogelijkheidsconfiguratie weer die is opgeslagen op het gekoppelde apparaat.

Opmerking

Met de opdracht worden de mogelijkheden weergegeven die zijn geconfigureerd met behulp van een mogelijkheidsbestand en sommige, maar niet alle, mogelijkheden die standaard aanwezig zijn op borden.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

capaciteitsupdate

Hiermee past u een configuratie van een apparaatmogelijkheid toe op het gekoppelde apparaat.

Vereiste parameters

Parameter Type Beschrijving
--capability-file Tekenreeks Hiermee geeft u het pad en de bestandsnaam van het toe te passen apparaatmogelijkheidsbestand. U kunt een relatief of absoluut pad opgeven.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld of wanneer er geen apparaat is gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt een apparaat-id opgeven voor een niet-gekoppeld apparaat of u kunt het IP-adres of de lokale verbindings-id van een gekoppeld apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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.

Certificaat

Hiermee beheert u certificaten op het gekoppelde apparaat.

Bewerking Beschrijving
Toevoegen Hiermee voegt u een certificaat toe aan het certificaatarchief op het gekoppelde apparaat.
Verwijderen Hiermee verwijdert u een certificaat uit het certificaatarchief van het gekoppelde apparaat.
Lijst Lijsten de certificaat-id's die beschikbaar zijn in het certificaatarchief van het gekoppelde apparaat.
Toon Geeft details weer van een certificaat in het certificaatarchief van het gekoppelde apparaat.
show-quota Geeft de beschikbare vrije ruimte weer in het certificaatarchief van het gekoppelde apparaat.

certificaat toevoegen

Hiermee voegt u een certificaat toe aan het certificaatarchief van het gekoppelde apparaat.

De basis-CA- en clientcertificaten moeten de PEM-indeling hebben om op het Azure Sphere-apparaat te kunnen worden geladen. U moet het basis-CA-certificaat verkrijgen van de juiste server, samen met het clientcertificaat en de persoonlijke sleutel (en optioneel een wachtwoord voor uw persoonlijke sleutel) voor uw apparaat. Elk certificaat moet worden gegenereerd en ondertekend door de juiste server in uw EAP-TLS-netwerk. Uw netwerkbeheerder of beveiligingsteam kan de details opgeven die u nodig hebt om de certificaten op te halen. Zie Certificaten verkrijgen en implementeren voor EAP-TLS-netwerken voor meer informatie over het verkrijgen van het basis-CA-certificaat.

Voorzichtigheid

Omdat certificaat-id's systeembreed zijn voor zowel client- als basis-CA-certificaten, kan een azsphere-opdracht of een functieaanroep waarmee een nieuw certificaat wordt toegevoegd, een certificaat overschrijven dat is toegevoegd door een eerdere opdracht of functieaanroep, waardoor netwerkverbindingsfouten kunnen optreden. We raden u ten zeerste aan duidelijke procedures voor het bijwerken van certificaten te ontwikkelen en certificaat-id's zorgvuldig te kiezen.

Zie Certificaat-id's voor meer informatie.

Vereiste parameters

Parameter Type Beschrijving
-i, --cert-id Tekenreeks Hiermee geeft u de id van het certificaat toe te voegen. Een tekenreeks-id (maximaal 16 tekens). Geldige tekens zijn hoofdletters (A-Z), kleine letters (a-z), cijfers (0-9), onderstrepingsteken (_), punt (.) en afbreekstreepje (-). Deze id wordt ook gebruikt in Wi-Fi configuraties voor EAP-TLS-netwerken.
--cert-type Tekenreeks Hiermee geeft u het type certificaat dat moet worden toegevoegd, client of rootca.
-p, --public-key-file Tekenreeks Hiermee geeft u het pad naar een pem-bestand met een openbare sleutelcertificaat op. U kunt een relatief of absoluut pad opgeven.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
--private-key-file Tekenreeks Hiermee geeft u het pad naar een .pem-bestand met een clientsleutelcertificaat op. Vereist bij het toevoegen van een certificaat van het type client. U kunt een relatief of absoluut pad opgeven.
-w, --private-key-password Tekenreeks Hiermee geeft u een optioneel wachtwoord voor de persoonlijke clientsleutel. Het wachtwoord is vereist wanneer u een persoonlijke sleutel voor een clientcertificaat toevoegt die is versleuteld.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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.

certificaat verwijderen

Hiermee verwijdert u een certificaat uit het certificaatarchief van het gekoppelde apparaat.

Vereiste parameters

Parameter Type Beschrijving
-c, --certificate
Of
--cert-id [wordt buiten gebruik gesteld]
Tekenreeks Hiermee geeft u de id van het certificaat te verwijderen. Het --cert-id argument wordt buiten gebruik gesteld en wordt in een toekomstige release verwijderd. Zie Belangrijke wijzigingen (functies buiten gebruik stellen) in Azure Sphere CLI voor meer informatie.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

azsphere device certificate delete --certificate certclient

certificaatlijst

Lijsten de certificaten die beschikbaar zijn in het certificaatarchief van het apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

certificaat weergeven

Toont details van een afzonderlijk certificaat in het certificaatarchief van het apparaat.

Vereiste parameters

Parameter Type Beschrijving
-c, --certificate
Of
--cert-id [wordt buiten gebruik gesteld]
Tekenreeks Hiermee geeft u de id op van het certificaat waarvoor de details moeten worden weergegeven. Het --cert-id argument wordt buiten gebruik gesteld en wordt in een toekomstige release verwijderd. Zie Belangrijke wijzigingen (functies buiten gebruik stellen) in Azure Sphere CLI voor meer informatie.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

certificaat show-quotum

Geeft de beschikbare vrije ruimte weer in het certificaatarchief van het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Vordering

Claimt een eerder niet-geclaimd apparaat voor de huidige Azure Sphere-tenant.

Belangrijk

Voordat u het apparaat claimt, moet u ervoor zorgen dat u bent aangemeld bij de juiste Azure Sphere-tenant. Een apparaat kan slechts één keer worden geclaimd. Zodra een apparaat is geclaimd, kan dit niet meer worden verplaatst naar een andere tenant.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld of wanneer er geen apparaat is gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt een apparaat-id opgeven voor een niet-gekoppeld apparaat of u kunt het IP-adres of de lokale verbindings-id van een gekoppeld apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
--Kracht Booleaanse Hiermee dwingt u af dat een apparaat wordt geclaimd in de geselecteerde Azure Sphere-tenant van de huidige gebruiker.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Leest het gekoppelde apparaat voor het testen van het laden in de cloud door toepassingsontwikkeling uit te schakelen, bestaande toepassingen te verwijderen en updates van toepassingen in de cloud in te schakelen.

Hiervoor moet een apparaat worden aangesloten op de pc en werkt het alleen op het gekoppelde apparaat.

Met name enable-cloud-test:

  • Hiermee verwijdert u de appDevelopment-mogelijkheid voor het gekoppelde apparaat.
  • Hiermee wijst u het apparaat toe aan een apparaatgroep die toepassingsupdates in de cloud mogelijk maakt.
  • Start het apparaat opnieuw op.

De specifieke taken die inschakelen-cloud-test uitvoert, zijn afhankelijk van of er al een product en apparaatgroep zijn toegewezen voor dit apparaat.

Als azsphere device enable-cloud-test wordt uitgevoerd zonder parameters, wordt het apparaat in de apparaatgroep Veldtest van het huidige product van het apparaat geplaatst. Dit is een van de standaardapparaatgroepen die automatisch voor elk product worden gemaakt, waardoor toepassingsupdates worden ingeschakeld. Er wordt een fout geretourneerd als het apparaat geen product heeft of als er geen veldtestapparaatgroep bestaat.

Als er een product is opgegeven, wordt het apparaat in de apparaatgroep Veldtest van dat product geplaatst. Er wordt een fout geretourneerd als deze apparaatgroep niet bestaat.

Als een apparaatgroep is opgegeven, wordt het apparaat erin geplaatst. Er wordt een fout geretourneerd als de doelapparaatgroep geen toepassingsupdates inschakelt.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-p, --product GUID of naam Hiermee geeft u het doelproduct op. Wanneer dit is opgegeven, wordt het apparaat verplaatst naar de standaard apparaatgroep Veldtest van dit product, tenzij --device-group dit ook is opgegeven. U kunt de id of naam van het Azure Sphere-product opgeven.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
-g, --device-group GUID of naam Hiermee geeft u de apparaatgroep op waarnaar het apparaat wordt verplaatst. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep in de <product-name/device-group-name> indeling opgeven. Standaard is dit de apparaatgroep Veldtest van het product.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeelden

Voorbeeld 1. Apparaat toewijzen aan bestaande apparaatgroep op id

In dit voorbeeld wordt het gekoppelde apparaat toegewezen aan een bestaand product en een bestaande apparaatgroep.

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')

Voorbeeld 2. Apparaat toewijzen aan een andere apparaatgroep

Dit voorbeeld is vergelijkbaar met het voorgaande voorbeeld, maar behoudt het bestaande product voor het apparaat. Hier wijzigt de bewerking enable-cloud-test de apparaatgroep waartoe het apparaat behoort en verwijdert de appDevelopment-mogelijkheid. Deze opdracht is handig voor het verplaatsen van een apparaat van een ontwikkelomgeving die geen toepassingsupdates inschakelt naar een productieomgeving die dat wel doet.

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

Voorbeeld 3. Apparaat toewijzen op productnaam

In dit voorbeeld wordt het laden in de cloud ingeschakeld en wordt het apparaat op naam toegewezen aan een product.

azsphere device enable-cloud-test --product DW100

enable-development

Hiermee schakelt u een apparaat in voor ontwikkeling door sideloading en foutopsporing op het apparaat in te schakelen en door het toe te wijzen aan een apparaatgroep die toepassingsupdates vanuit de cloud uitschakelt. Standaard is dit de apparaatgroep Ontwikkeling van het product van het apparaat, maar andere apparaatgroepen kunnen worden opgegeven. Niet gebruiken in productiescenario's. Zie Verbonden apparaten maken voor meer informatie.

Met name enable-development:

  • Downloadt en past de appDevelopment-mogelijkheid voor het gekoppelde apparaat toe.
  • Hiermee wijst u het apparaat toe aan een apparaatgroep die geen toepassingsupdates in de cloud inschakelt.
  • Start het apparaat opnieuw op.

Als u de opdracht azsphere device enable-development uitvoert zonder parameters:

  • Als het apparaat nog geen product of apparaatgroep heeft, wordt met de opdracht de appDevelopment-mogelijkheid voor het gekoppelde apparaat gedownload en toegepast en wordt het apparaat opnieuw opgestart. Alle bestaande apps blijven op het apparaat staan en het besturingssysteem wordt bijgewerkt. Het installatieproces voor het claimen van uw apparaat en de quickstart voor het bouwen van een toepassing op hoog niveau worden niet beïnvloed.
  • Als het apparaat al een product heeft, wordt het apparaat met de opdracht verplaatst naar de apparaatgroep Ontwikkeling van het product. Toepassingsupdates zijn standaard uitgeschakeld voor deze groep, zodat sideloaded apps niet worden overschreven.

Als u de opdracht azsphere device enable-development uitvoert met de --product parameter:

  • Places het apparaat in de apparaatgroep Ontwikkeling voor het product. Er wordt een fout geretourneerd als deze apparaatgroep niet bestaat.

Als u de opdracht azsphere device enable-development uitvoert met de --device-group parameter:

  • Places het apparaat in de opgegeven apparaatgroep is opgegeven. De doelapparaatgroep mag geen toepassingsupdates inschakelen of er wordt een fout geretourneerd.

In sommige gevallen meldt azsphere device enable-development een fout en stelt u voor dat u het apparaat claimt. Als u het apparaat al hebt geclaimd, gebruikt u azsphere tenant show-selected om ervoor te zorgen dat u bent aangemeld bij de tenant waarin u het apparaat hebt geclaimd. Als dat niet het probleem is, gebruikt u azsphere-aanmelding om u aan te melden bij de juiste tenant. Wanneer u zeker weet dat u bent aangemeld bij de juiste tenant, gebruikt u azsphere-apparaatclaim om het apparaat te claimen.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-g, --device-group GUID of naam Hiermee geeft u de apparaatgroep op waarnaar het apparaat wordt verplaatst. Als u dit weglaat, wijst u het apparaat toe aan een standaardgroep. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep in de <product-name/device-group-name> indeling opgeven.
-r, --enable-rt-core-foutopsporing Booleaanse Installeert stuurprogramma's die nodig zijn om fouten op te sporen in toepassingen die worden uitgevoerd op een realtime kern. Voor deze optie zijn beheerdersmachtigingen vereist.
-p, --product GUID of naam Hiermee geeft u het doelproduct op. Wanneer u deze waarde opgeeft, wordt het apparaat verplaatst naar de standaardapparaatgroep Ontwikkeling van dit product, tenzij --device-group ook wordt opgegeven. U kunt de id of naam van het Azure Sphere-product opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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')

Afbeelding

Retourneert informatie over de installatiekopieën die zijn geïnstalleerd op of gericht zijn op het gekoppelde apparaat.

Bewerking Beschrijving
list-installed Bevat details over de installatiekopieën die momenteel op het gekoppelde apparaat zijn geïnstalleerd.
list-targeted Geeft details over de afbeeldingen die zijn gericht op het gekoppelde apparaat.

installatiekopieënlijst geïnstalleerd

Lijsten de installatiekopieën die op het gekoppelde apparaat zijn geïnstalleerd. De lijst met informatie bevat de onderdeel- en installatiekopieën-id's.

Opmerking

Lange installatiekopieën worden afgekapt met 31 tekens.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-f, --full Booleaanse Lijsten alle software-installatiekopieën die op het apparaat zijn geïnstalleerd. Standaard worden alleen toepassingsinstallatiekopieën, foutopsporingsprogramma's en installatiekopieën voor bordconfiguratie weergegeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Lijsten de installatiekopieën die zijn geüpload naar de Azure Sphere-beveiligingsservice en worden geïnstalleerd wanneer het apparaat wordt bijgewerkt. Zie Cloudimplementatie inschakelen voor uw apparaat voor meer informatie over hoe u ervoor kunt zorgen dat uw Azure Sphere-apparaat klaar is om updates voor cloudtoepassingen te accepteren.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld of wanneer er geen apparaat is gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt een apparaat-id opgeven voor een niet-gekoppeld apparaat of u kunt het IP-adres of de lokale verbindings-id van een gekoppeld apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
-f, --full Booleaanse Lijsten alle installatiekopieën in uw Azure Sphere-tenant.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Lijst

Lijsten alle apparaten in een tenant. De lijst wordt afgekapt na de eerste 500 apparaten.

Optionele parameters

Parameter Type Beschrijving
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

U kunt de --query parameter gebruiken om de uitvoer aan te passen die voor deze opdracht wordt weergegeven. Zie Query CLI-opdrachtuitvoer voor meer informatie.

In het volgende voorbeeld ziet u hoe u alleen de apparaat-id en product-id selecteert:

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

Tip

Voer de azsphere-product show --product-ID <> uit om de productnaam weer te geven of de azsphere device-group show --device-group <devicegroup-ID> om de naam van de apparaatgroep weer te geven.

list-attached

Lijsten de apparaten die zijn aangesloten op de lokale pc.

Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

productiestatus

Hiermee beheert u de productiestatus van het gekoppelde apparaat.

Bewerking Beschrijving
Toon Geeft de productiestatus van het gekoppelde apparaat weer.
Update Updates de productiestatus van het gekoppelde apparaat.

Voorzichtigheid

Wijzigingen in de productiestatus zijn permanent en onomkeerbaar.

productiestatus weergeven

Geeft de productiestatus van het gekoppelde apparaat weer.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

productiestatusupdate

Updates de productiestatus van het gekoppelde apparaat. Zie De productiestatus van het apparaat instellen voor meer informatie.

Voorzichtigheid

Wijzigingen in de productiestatus zijn permanent en onomkeerbaar.

Vereiste parameters

Parameter Type Beschrijving
-s, --status Productiestatussen Hiermee geeft u de productiestatus die moet worden ingesteld voor het apparaat. Mogelijke statussen zijn en DeviceCompleteModule1Complete.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Netwerk

Biedt informatie over de status van netwerkinterfaces op het gekoppelde apparaat.

Bewerking Beschrijving
Inschakelen Hiermee schakelt u een netwerkinterface in op het gekoppelde apparaat.
Uitschakelen Hiermee schakelt u een netwerkinterface op het gekoppelde apparaat uit.
list-firewall-rules Lijsten de firewallregels voor het gekoppelde apparaat.
list-interfaces Lijsten de netwerkinterfaces voor het gekoppelde apparaat.
Proxy Hiermee beheert u de netwerkproxy-instellingen.
show-diagnostics Toont netwerkdiagnose voor een of alle draadloze netwerken op het gekoppelde apparaat.
show-status Toont de netwerkstatus voor het gekoppelde apparaat.
update-interface Updates een netwerkinterfaceconfiguratie voor het apparaat.

netwerk inschakelen

Hiermee schakelt u een netwerkinterface in op het gekoppelde apparaat.

Opmerking

Deze opdracht wordt ondersteund voor het configureren van Ethernet eth0 en wlan0 verbindingen. Er wordt een fout geretourneerd als u of azspheresvcconfigureertlo.

Vereiste parameters

Parameter Type Beschrijving
--Interface Tekenreeks Hiermee geeft u de interface op die moet worden ingeschakeld.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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.

netwerk uitschakelen

Hiermee schakelt u een netwerkinterface op het gekoppelde apparaat uit.

Opmerking

Deze opdracht wordt ondersteund voor het configureren van Ethernet eth0 en wlan0 verbindingen. Er wordt een fout geretourneerd als u of azspheresvcconfigureertlo.

Vereiste parameters

Parameter Type Beschrijving
--Interface Tekenreeks Hiermee geeft u de interface op die moet worden ingeschakeld.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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.

netwerklijst-firewallregels

Lijsten de firewallregels voor het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.

De volgende regels worden weergegeven:

  • Naam van firewallregelset: geeft de naam van het firewallregelsetblok weer.
    • De waarden zijn PREROUTING, POSTROUTING, INPUT, FORWARD en OUTPUT.
  • Is regelset geldig: geeft de status van de regelset weer. De waarden zijn Waar of Onwaar.
  • Regels voor firewallregelset: geeft de waarden voor de volgende regels weer:
    • Bron-IP: geeft het IP-adres van de verzendende machine weer.
    • Bronmasker: geeft het netwerkmasker van de verzendende machine weer.
    • Doel-IP: geeft het IP-adres van de doelcomputer weer.
    • Doelmasker: geeft het netwerkmasker van de ontstomingscomputer weer.
    • UID: geeft de gebruikersidentificatie weer die is toegepast op de regel. 4294967295 (0xFFFFFFFF) betekent dat er geen UID is toegepast en dat deze daarom op iedereen van toepassing is.
    • Actie: geeft de actie weer die moet worden uitgevoerd. De waarden kunnen worden geaccepteerd of wegvallen.
    • Interface IN-naam: geeft de naam van de invoerinterface weer. Bijvoorbeeld wlan0.
    • Interface OUT-naam: geeft de naam van de uitvoerinterface weer. Bijvoorbeeld wlan0.
    • Status: geeft de verbindingsstatus weer. De waarden zijn geen, ingesteld of gerelateerd.
    • TCP-masker: geeft de matrix met TCP-maskers weer. De waarden zijn fin, syn, rst, psh, ack en urg.
    • TCP Cmp: geeft de matrix met TCP-vlaggen weer. De waarden zijn urg, ack, psh, rst, syb en fin.
    • TCP Inv: Booleaanse waarde geeft aan dat de tcp-markeringen moeten worden omgedraaid. De waarden zijn Waar of Onwaar.
    • Protocol: geeft het protocol van de firewallregel weer. De waarden zijn icmp, igmp, tcp, udp.
    • Bronpoortbereik: geeft het poortbereik weer van de bron waarmee het verkeer wordt verzonden. De waarde kan tussen 0 en 65535 zijn.
    • Doelpoortbereik: geeft het poortbereik weer op de bestemming die het verkeer ontvangt. De waarde kan tussen 0 en 65535 zijn.
    • Pakketten: geeft het aantal pakketten weer.
    • Bytes: geeft het aantal bytes weer.

Een kort overzicht van de vlaggen wordt als volgt weergegeven:

  • URG: veld urgente aanwijzer significant
  • ACK: Bevestigingsveld significant
  • PSH: pushfunctie
  • RST: de verbinding opnieuw instellen
  • SYN: volgnummers synchroniseren
  • FIN: Geen gegevens van afzender meer
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------

netwerklijst-interfaces

Lijsten de netwerkinterfaces voor het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

netwerkproxy

Hiermee beheert u het gebruik van proxyadressen voor de netwerkverbinding. Zie Verbinding maken via een proxyserver voor meer informatie over het configureren van een Azure Sphere-apparaat om verbinding te maken met internet via een proxyserver.

Opmerking

Alleen HTTP-proxy's worden momenteel ondersteund.

Bewerking Beschrijving
proxy toepassen Hiermee configureert u de netwerkproxy op het gekoppelde apparaat.
proxy verwijderen Hiermee verwijdert u de proxyverbinding op het gekoppelde apparaat.
proxyvoorstelling Hiermee wordt de proxyverbinding op het gekoppelde apparaat weergegeven.

proxy toepassen

Hiermee configureert u de netwerkproxy op het gekoppelde apparaat.

Vereiste parameters

Parameter Type Beschrijving
-a, --address Tekenreeks Hiermee geeft u het netwerkadres van de proxy te gebruiken.
-t, --verificatie Tekenreeks Hiermee geeft u het verificatietype op dat moet worden gebruikt. Toegestane waarden: anonymous of basic. Als de proxy een gebruikersnaam en wachtwoord vereist, stelt u deze in op basic, anders gebruikt u anonymous.
-r, --port Geheel getal Hiermee geeft u de poort op het te gebruiken netwerkadres. De waarde moet gelijk zijn aan of kleiner zijn dan 65535.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
--Inschakelen Tekenreeks Hiermee geeft u op of de proxy moet worden ingeschakeld. U moet of --enable--disableinstellen.
--Uitschakelen Tekenreeks Hiermee geeft u op of de proxy moet worden uitgeschakeld. U moet of --enable--disableinstellen.
-n, --geen-proxy-adressen Tekenreeks Hiermee geeft u een matrix met door ruimte gescheiden netwerkadressen die het apparaat moet vermijden voor proxyverbinding.
-p, --password Tekenreeks Hiermee geeft u het wachtwoord voor proxyverificatie alleen gebruikt voor basisverificatie. Maximale lengte: 64 tekens.
-u, --gebruikersnaam Tekenreeks Hiermee geeft u de gebruikersnaam voor proxyverificatie. Alleen gebruikt voor basisverificatie. Maximale lengte: 64 tekens.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

proxy verwijderen

Hiermee verwijdert u de proxyverbinding op het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

azsphere device network proxy delete

proxyvoorstelling

Hiermee wordt de proxyverbinding op het gekoppelde apparaat weergegeven.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

network show-diagnostics

Toont diagnostische gegevens voor een of alle Wi-Fi netwerken op het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-n, --network Geheel getal Hiermee geeft u de id van het Wi-Fi netwerk waarvoor diagnostische gegevens moeten worden weergegeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

netwerk show-status

Toont de netwerkstatus voor het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

netwerkupdate-interface

Updates de Ethernet-netwerkinterface voor het apparaat. Zie Het apparaat configureren voor Ethernet voor meer informatie over het instellen van het MAC-adres voor het apparaat.

Opmerking

Deze opdracht wordt ondersteund voor het configureren van Ethernet-verbindingen eth0 . Er wordt een fout geretourneerd als u , azspheresvc of wlan0configureertlo.

Vereiste parameters

Parameter Type Beschrijving
--hardware-adres Tekenreeks Hiermee geeft u het hardwareadres dat moet worden ingesteld voor het apparaat in een van de volgende indelingen: AA:BB:33:DD:EE:FF of aa:bb:33:dd:ee:ff.
--Interface
Of
--interface-name [wordt buiten gebruik gesteld]
Tekenreeks Hiermee geeft u de naam van de interface te configureren. Voer azsphere device network list-interfaces uit om details van de netwerkinterfaces voor het gekoppelde apparaat weer te geven. Het --interface-name argument wordt buiten gebruik gesteld en wordt in een toekomstige release verwijderd. Zie Belangrijke wijzigingen (functies buiten gebruik stellen) in Azure Sphere CLI voor meer informatie.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Herstellen

Vervangt de systeemsoftware op het apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat op waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. Geef de id, het IP-adres of de lokale verbinding-id van het apparaat op.
-c, --mogelijkheid Tekenreeks Hiermee geeft u de installatiekopieën van het apparaat op die tijdens het herstel moeten worden toegepast op het apparaat.
-i, --images Tekenreeks Hiermee geeft u het pad op naar een map die de installatiekopieënpakketten bevat om naar het apparaat te schrijven. Herstel maakt standaard gebruik van de installatiekopieën in de SDK, tenzij er een alternatief pad is opgegeven met deze vlag.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

Voorbeeld 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.

Voorbeeld 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.

bijgevoegde scan opnieuw

Scant de gekoppelde apparaten opnieuw door alle FTDI-poorten aan te zetten en geeft het totale aantal gekoppelde apparaten weer. Gebruik deze opdracht bij het oplossen van apparaatverbindingsproblemen in Windows. Deze opdracht wordt alleen uitgevoerd in Windows.

Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Opnieuw starten

Start het gekoppelde apparaat opnieuw op.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

azsphere device restart
Restarting device.
Device restarted successfully.

Toon

Geeft details weer van een gekoppeld apparaat in uw Azure Sphere-tenant.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld of wanneer er geen apparaat is gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt een apparaat-id opgeven voor een niet-gekoppeld apparaat of u kunt het IP-adres of de lokale verbindings-id van een gekoppeld apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

U kunt de --query parameter gebruiken om de uitvoer aan te passen die voor deze opdracht wordt weergegeven. Zie Query CLI-opdrachtuitvoer voor meer informatie.

In het volgende voorbeeld ziet u hoe u alleen de apparaat-id en product-id selecteert:

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

show-attached

Geeft informatie weer over het gekoppelde apparaat van het apparaat zelf. Deze details verschillen van de gegevens die de Azure Sphere-beveiligingsservice voor het apparaat opslaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

show-deployment-status

Geeft de implementatiestatus van toepassings- en besturingssysteemupdates voor het apparaat weer.

Gebruik deze opdracht om erachter te komen welke versie van het Azure Sphere-besturingssysteem op uw apparaat wordt uitgevoerd of dat de huidige implementatie-update is voltooid.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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>.

In dit voorbeeld <vertegenwoordigt versienummer> de huidige versie van het besturingssysteem.

show-count

Geeft het aantal apparaten in de huidige tenant weer.

Optionele parameters

Parameter Type Beschrijving
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

show-os-version

Geeft de huidige versie van het besturingssysteem op het gekoppelde apparaat weer.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

In dit voorbeeld <vertegenwoordigt versienummer> de huidige versie van het besturingssysteem.

sideloaden

Hiermee beheert u de toepassing op het apparaat.

Voor sommige sideloadopties zijn extra mogelijkheden vereist zodra het apparaat de productiestatus DeviceComplete heeft. Met de fieldServicing-mogelijkheid kunt u tijdelijke installatiekopieën met productieondertekening implementeren en verwijderen en permanente installatiekopieën met productieondertekening implementeren. Met de appDevelopment-mogelijkheid kunt u zowel door de productie ondertekende als de SDK-installatiekopieën implementeren en verwijderen.

Bewerking Beschrijving
Verwijderen Hiermee verwijdert u de huidige toepassing van het apparaat.
Implementeren Laadt een toepassing op het apparaat.
set-deployment-time-out Hiermee stelt u de time-outperiode voor de implementatie in seconden in.
show-deployment-time-out Toont de time-outperiode van de implementatie in seconden.

Houd er rekening mee dat de parameters naar start, stop, show-statusen show-quota zijn verplaatst naar de opdracht azsphere device app .

sideload verwijderen

Hiermee verwijdert u toepassingen van het apparaat.

Deze opdracht is alleen beschikbaar als de appDevelopment-apparaatmogelijkheid is geconfigureerd.

Optionele parameters

Parameter Type Beschrijving
-i, --component-id GUID Hiermee geeft u de id van de toepassing te verwijderen van het apparaat. Als u dit weglaat, verwijdert u alle toepassingen.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

sideload implementeren

Laadt een toepassing op het gekoppelde apparaat en start de toepassing.

Deze opdracht mislukt als het toepassingsmanifest een resource aanvraagt die wordt gebruikt door een toepassing die zich al op het apparaat bevindt. Gebruik in dit geval azsphere device sideload delete om de bestaande toepassing te verwijderen en probeer vervolgens opnieuw te sideloaden. Met de opdracht azsphere device sideload delete verwijdert u zowel toepassingen op hoog niveau als toepassingen in realtime. Als u de ene toepassing wilt verwijderen en de andere wilt laten staan, geeft u de onderdeel-id op van de toepassing die u wilt verwijderen.

Dezelfde opdracht wordt gebruikt voor het implementeren van toepassingen op hoog niveau en toepassingen die geschikt zijn voor realtime.

Opmerking

Het opnieuw opstarten van het apparaat wordt geactiveerd wanneer een nieuwe toepassing die randapparatuur gebruikt, wordt geïnstalleerd en aan de volgende voorwaarden wordt voldaan:

Als een apparaat opnieuw wordt opgestart, wacht u totdat het opnieuw opstarten is voltooid en het apparaat reageert.

Vereiste parameters

Parameter Type Beschrijving
-p, --image-package Tekenreeks Hiermee geeft u het pad en de bestandsnaam van het installatiekopieënpakket op het apparaat te laden.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-m, --manual-start Booleaanse Hiermee geeft u op dat de toepassing niet automatisch wordt gestart nadat deze is geladen.
--Kracht Booleaanse Hiermee dwingt u de implementatie af van een installatiekopieën die gebruikmaakt van een bèta-API die mogelijk niet meer wordt ondersteund.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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.

sideload set-deployment-time-out

Hiermee stelt u de time-outwaarde voor de implementatie in seconden in voor het sideloaden van installatiekopieën op het apparaat.

Vereiste parameters

Parameter Type Beschrijving
-v, --value Geheel getal Hiermee geeft u de duur in seconden op voordat er een time-out optreedt voor een sideload-opdracht. De waarde moet een positief geheel getal zijn.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

sideload show-deployment-timeout

Geeft de huidige time-outwaarde voor implementatie in seconden weer voor sideloading-installatiekopieën op het apparaat.

Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Update

Hiermee verplaatst u het apparaat naar een andere apparaatgroep in uw Azure Sphere-tenant.

Naast apparaatgroepen die u in een product maakt, worden er vijf standaardapparaatgroepen toegevoegd wanneer een product wordt gemaakt:

  • Ontwikkeling: accepteert alleen systeemsoftware-updates. Accepteert geen toepassingsupdates.
  • Veldtest: accepteert alle updates van de Azure Sphere-beveiligingsservice.
  • Productie: accepteert alle updates van de Azure Sphere-beveiligingsservice.
  • Evaluatie van productiebesturingssystemen: accepteert alle updates van de Azure Sphere-beveiligingsservice.
  • Evaluatie van veldtest van besturingssysteem: accepteert alle updates van de Azure Sphere-beveiligingsservice.

Zie Basisbeginselen van implementatie voor meer informatie over fundamentele elementen die betrokken zijn bij de implementatie.

Optionele parameters

Parameter Type Beschrijving
-g, --device-group GUID of naam Hiermee geeft u de apparaatgroep op waarin het apparaat moet worden verplaatst. U kunt de apparaatgroep-id of de naam van de apparaatgroep opgeven. Als u de naam van de apparaatgroep wilt gebruiken, moet u zowel de productnaam als de naam van de apparaatgroep in de <product-name/device-group-name> indeling opgeven.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld of wanneer er geen apparaat is gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt een apparaat-id opgeven voor een niet-gekoppeld apparaat of u kunt het IP-adres of de lokale verbindings-id van een gekoppeld apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
-t, --tenant GUID of naam Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft de standaard geselecteerde tenant. U kunt de tenant-id of tenantnaam opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------

U kunt de --query parameter gebruiken om de uitvoer aan te passen die voor deze opdracht wordt weergegeven. Zie Query CLI-opdrachtuitvoer voor meer informatie.

In het volgende voorbeeld ziet u hoe u alleen de apparaat-id en product-id selecteert:

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

Wifi

Hiermee beheert u Wi-Fi configuraties voor het gekoppelde apparaat.

Als u het apparaat op een Wi-Fi netwerk wilt gebruiken, moet u informatie over het netwerk toevoegen en het netwerk op het apparaat inschakelen. Hoewel u niet-ASCII-tekens kunt invoeren in SSID's, worden deze niet correct weergegeven in azsphere .

Als uw toepassing gebruikmaakt van de Wi-Fi-configuratie-API, moet u ook de mogelijkheid WifiConfig opnemen in het app_manifest.json-bestand van de toepassing.

Bewerking Beschrijving
Toevoegen Hiermee voegt u de details van een draadloos netwerk toe aan het apparaat.
Uitschakelen Hiermee schakelt u een draadloos netwerk op het apparaat uit.
Inschakelen Hiermee schakelt u een draadloos netwerk op het apparaat in.
Vergeten Hiermee verwijdert u de details van een draadloos netwerk van het apparaat.
Lijst Lijsten de huidige Wi-Fi configuratie voor het apparaat.
herlaadconfiguratie Laadt het apparaat opnieuw Wi-Fi configuratie.
Scan Hiermee wordt gescand op beschikbare netwerken.
Toon Geeft details weer van een Wi-Fi configuratie.
show-status Geeft de status van de draadloze interface weer.

wifi toevoegen

Hiermee voegt u details van een Wi-Fi netwerk toe aan het gekoppelde apparaat.

Een apparaat kan meerdere Wi-Fi verbindingen hebben. Hoewel u niet-ASCII-tekens kunt invoeren in SSID's, worden deze niet correct weergegeven in azsphere . U kunt de --targeted-scan parameter opnemen om verbinding te maken met verborgen SSID's. Zie Azure Sphere verbinden met Wi-Fi voor meer informatie.

Vereiste parameters

Parameter Type Beschrijving
-s, --ssid Tekenreeks Hiermee geeft u de SSID van het netwerk. Netwerk-SSID's zijn hoofdlettergevoelig.

Optionele parameters

Parameter Type Beschrijving
--client-cert-id Tekenreeks [EAP-TLS] Hiermee geeft u de id (maximaal 16 tekens) die het clientcertificaat identificeert (met zowel de openbare als de persoonlijke sleutel). Vereist voor het instellen van een EAP-TLS-netwerk.
--client-id <user@domain> Tekenreeks [EAP-TLS] Hiermee geeft u de id die wordt herkend voor verificatie door de RADIUS-server van het netwerk. Vereist voor sommige EAP-TLS-netwerken.
--config-name Tekenreeks Hiermee geeft u een tekenreeks op (maximaal 16 tekens) die de naam voor de netwerkconfiguratie opgeeft.
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
--root-ca-cert-id Tekenreeks [EAP-tLS] Hiermee geeft u de id (maximaal 16 tekens) op die het basis-CA-certificaat van de server identificeert voor EAP-TLS-netwerken waar het apparaat de server verifieert.
--targeted-scan Booleaanse Probeert verbinding te maken met een netwerk, zelfs als het netwerk niet uitzendt of verborgen is door netwerkcongestie.
-p, --psk Tekenreeks Hiermee geeft u de WPA/WPA2-sleutel voor het nieuwe netwerk. Weglaten om de SSID toe te voegen als een open netwerk. Als uw sleutel een ampersand (&) bevat, plaatst u de sleutel tussen aanhalingstekens.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Als de netwerk-SSID of -sleutel ingesloten spaties of een ampersand heeft, plaatst u de SSID of sleutel tussen enkele aanhalingstekens. Als de SSID of sleutel een aanhalingsteken bevat, gebruikt u een backslash om het aanhalingsteken te laten ontsnappen. Backslashes hoeven niet te worden ge escaped als ze deel uitmaken van een waarde. Zie Aanhalingstekens en escapetekens voor meer informatie. Bijvoorbeeld:

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

wifi uitschakelen

Hiermee schakelt u een Wi-Fi netwerk op het gekoppelde apparaat uit.

Vereiste parameters

Parameter Type Beschrijving
-i, --id Geheel getal Hiermee geeft u de id van het netwerk uit te schakelen.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

wifi inschakelen

Hiermee schakelt u een Wi-Fi netwerk in op het gekoppelde apparaat.

Als u wilt overschakelen van het ene netwerk naar het andere als beide zich binnen het bereik bevinden, schakelt u het netwerk dat momenteel is verbonden uit voordat u het nieuwe netwerk inschakelt.

Vereiste parameters

Parameter Type Beschrijving
-i, --id Geheel getal Hiermee geeft u de id van het netwerk in te schakelen.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

wifi vergeten

Hiermee verwijdert u details van een Wi-Fi netwerk van het gekoppelde apparaat.

Vereiste parameters

Parameter Type Beschrijving
-i, --id Geheel getal Hiermee geeft u de id van het netwerk te verwijderen.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

wifi-lijst

Lijsten de huidige Wi-Fi configuratie voor het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Hiermee wordt de Wi-Fi netwerkconfiguratie op het gekoppelde apparaat opnieuw geladen. Gebruik deze opdracht nadat u een certificaat (azsphere-apparaatcertificaat) hebt toegevoegd of verwijderd om ervoor te zorgen dat EAP-TLS-netwerken de meest recente inhoud van het certificaatarchief gebruiken.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

wifi scan

Zoeken naar beschikbare Wi-Fi netwerken die zichtbaar zijn voor het gekoppelde apparaat. De opdracht retourneert maximaal 64 Wi-Fi netwerken, maar het aantal weergegeven Wi-Fi netwerken kan worden beperkt door omgevingsfactoren, zoals de dichtheid van toegangspunten in het bereik.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

Toont details van een Wi-Fi netwerk op het gekoppelde apparaat.

Vereiste parameters

Parameter Type Beschrijving
-i, --id Geheel getal Hiermee geeft u de id van de netwerkconfiguratie weer te geven.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

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

wifi show-status

Toont de status van de Wi-Fi interface op het gekoppelde apparaat.

Optionele parameters

Parameter Type Beschrijving
-d, --device Tekenreeks Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, wordt standaard gebruikt. U kunt de apparaat-id, het IP-adres of de lokale verbindings-id van het gekoppelde apparaat opgeven.
Azure Sphere CLI ondersteunt meerdere MT3620-apparaten in Windows, maar u kunt slechts één apparaat tegelijk verbinden in Linux. Daarom wordt deze parameter ondersteund voor Windows, maar niet voor Linux. Er wordt een fout geretourneerd als u deze parameter gebruikt met de opdracht in Linux.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.

Voorbeeld

 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>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------