klientorganisation
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Hanterar en Azure Sphere-klientorganisation.
Viktigt!
Kommandona azsphere tenant download-ca-certificate, azsphere tenant download-ca-certificate-chainoch azsphere tenant download-validation-certificate är föråldrade. Använd azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proofoch azsphere ca-certificate list i stället.
I Azure Sphere CLI väljs inte standardklientorganisationen automatiskt när en klientorganisation skapas. Du måste köra kommandot azsphere tenant select för att välja den standardklientorganisation som ska användas för den aktuella användaren på datorn. Detta är för att säkerställa att standardklientorganisationen är rätt klient att använda när du utför en engångsåtgärd som du inte kan ångra, som att göra anspråk på enheten.
| Operation | beskrivning |
|---|---|
| skapa | Skapar en ny klientorganisation. |
| download-error-report | Returnerar felinformation för enheter i den aktuella klientorganisationen. |
| lista | Visar en lista över tillgängliga Azure Sphere-klienter. |
| utvald | Väljer den Azure Sphere-standardklientorganisation som ska användas på den här datorn. |
| show-selected | Visar standardklientorganisationen för Azure Sphere för den här datorn. |
| uppdatera | Uppdaterar klientorganisationens information, till exempel namnet på klientorganisationen. |
skapa
Skapar en ny Azure Sphere-klientorganisation. En ansluten enhet krävs för att köra det här kommandot. Mer information finns i Skapa en Azure Sphere-klientorganisation.
Om du redan har en klientorganisation och är säker på att du vill ha en till använder du parametern --force-additional . För närvarande kan du inte ta bort en Azure Sphere-klientorganisation.
När klientorganisationen har skapats kör du azsphere-klientorganisationen och väljer den standardklient som ska användas för den aktuella användaren på den här datorn. Du kan lägga till roller för användare i den aktuella Azure Sphere-klientorganisationen med hjälp av kommandot azsphere role add .
Kommandot azsphere tenant create fungerar med en lokalt ansluten Azure Sphere-enhet. Om du försöker köra kommandot utan en ansluten enhet får du ett felmeddelande. Enhets-ID:t registreras när du skapar en klientorganisation och endast en klientorganisation kan skapas per enhet.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -n, --name | String | Anger ett namn för klientorganisationen. När du namnger din klientorganisation ska du använda alfanumeriska tecken. Specialtecken är inte tillåtna. Namnet får inte överstiga 50 tecken och är skiftlägeskänsligt. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -d, --device | String | Anger vilken enhet som kommandot ska köras på när flera enheter är anslutna. Den här parametern krävs när flera enheter är anslutna. Den anslutna enheten används som standard. Du kan ange enhets-ID, IP-adress eller lokalt anslutnings-ID för den anslutna enheten. Azure Sphere CLI stöder flera MT3620-enheter i Windows, men du kan bara ansluta en enhet i taget i Linux. Därför stöds den här parametern för Windows men inte för Linux. Ett fel returneras om du använder den här parametern med kommandot på Linux. |
| --force-additional | Booleskt | Tvingar fram skapandet av en ny Azure Sphere-klientorganisation. Använd endast det här kommandot om du är säker på att du vill använda det aktuella kontot för att skapa en ny Azure Sphere-klientorganisation med den anslutna enheten. |
| --disable-confirm-prompt | Booleskt | Inaktiverar uppmaningen om användarbekräftelse. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere tenant create --name MyTenant
Använd parametrarna --force-additional och --disable-confirm-prompt om du är säker på att du vill använda det här kontot för att skapa en ny Azure Sphere-klientorganisation med den anslutna enheten. En enhet som tidigare har använts för att skapa en Azure Sphere-klientorganisation kan inte användas för att skapa en ny klientorganisation.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
Dricks
När du har skapat en klientorganisation kontrollerar du att du kör azsphere tenant select för att välja den standardklient som ska användas för den aktuella användaren på den här datorn.
download-error-report
Returnerar information om fel som rapporterats av enheter i den aktuella klientorganisationen.
Det här kommandot hämtar händelsedata från Azure Sphere Security Service-molnet och kräver ingen fysisk anslutning till en viss enhet. Kommandot azsphere tenant download-error-report fungerar i kontexten för den aktuella klientorganisationen och returnerar felrapporter för alla enheter i klientorganisationen.
Kommentar
Det kan ta upp till 24 timmar innan nyligen rapporterade händelser är tillgängliga för nedladdning. Mer information finns i Samla in och tolka feldata.
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| --destination | String | Anger sökvägen och filnamnet för utdatafilen. |
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
lista
Visar en lista över Azure Sphere-klientorganisationer.
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
välj
Väljer den Azure Sphere-standardklientorganisation som ska användas för den aktuella användaren på den här datorn.
Om du vill visa den aktuella standardklientorganisationen använder du azsphere tenant show-selected.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
show-selected
Visar information om standardklientorganisationen för Azure Sphere för den aktuella användaren på den här datorn.
Det här är den klientorganisation som valts med kommandot azsphere tenant select .
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
update
Uppdaterar en klientorganisations information, till exempel namnet på klientorganisationen.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -n, --new-name | String | Anger ett nytt namn för klientorganisationen. När du namnger din klientorganisation ska du använda alfanumeriska tecken. Specialtecken är inte tillåtna. Namnet får inte överstiga 50 tecken och är skiftlägeskänsligt. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Dricks
Om du inte har valt en standardklient visas en lista över tillgängliga klienter. Ange din standardklient genom att välja något av alternativen.