Hantera klientorganisationer
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).
En Azure Sphere-klientorganisation utgör ett säkert sätt för din organisation att fjärrhantera sina Azure Sphere-enheter isolerat från andra kunders enheter. Din organisation måste skapa en Azure Sphere-klientorganisation och sedan begära var och en av sina enheter till den klientorganisationen, så att du kan fjärrhantera dessa enheter på ett säkert sätt.
Förutsättningar
- Installera Azure Sphere SDK för Windows eller linux.
- Du måste ha en oanmäld enhet som inte tidigare har använts för att skapa en klientorganisation.
Skapa en Azure Sphere-klientorganisation
En Azure Sphere-klientorganisation isolerar dina Azure Sphere-enheter och ger dig ett sätt att organisera och distribuera program. Kontot som skapar klientorganisationen tilldelas automatiskt rollen som administratör för klientorganisationen.
Dricks
- När en klientorganisation har skapats kan den inte tas bort och enheter kan inte migreras mellan klienter. Om ditt team eller din organisation redan har en Azure Sphere-klientorganisation kan du begära åtkomst till den i stället för att skapa ytterligare en klientorganisation.
Så här skapar du en Azure Sphere-klientorganisation:
Anslut en Azure Sphere-enhet till datorn via USB.
Öppna ett Azure Sphere CLI med hjälp av PowerShell, Windows-kommandotolken eller Linux-kommandogränssnittet.
Logga in på CLI genom att följa anvisningarna här.
Om du vill skapa klientorganisationen anger du följande kommando:
azsphere tenant create --name <tenant-name or tenant-ID>Ersätt <klientorganisationens namn> med ett namn som andra användare kan känna igen, till exempel "Contoso Ltd" eller "Contoso Diskmaskinsdivision". När du namnger din klient använder du endast alfanumeriska tecken och blanksteg. Om du inkluderar blanksteg omger du namnet inom citattecken. Namnet får inte börja med ett blanksteg eller mer än 50 tecken. Specialtecken är inte tillåtna. Namnen är skiftlägeskänsliga.
När du skapar en klientorganisation registrerar Azure Sphere Security Service enhets-ID:t för den anslutna enheten. Varje enhets-ID kan bara användas för att skapa en Azure Sphere-klientorganisation.
Om ditt konto redan har åtkomst till en Azure Sphere-klientorganisation misslyckas kommandot och du uppmanas att använda den befintliga klientorganisationen. Om du är säker på att du vill skapa en ny klientorganisation kan du använda parametern --force-additional för att tvinga fram att en ny Azure Sphere-klientorganisation skapas.
Kommandot azsphere tenant create skapar en klient men gör inte anspråk på enheten i klientorganisationen. Mer information finns i Anspråk på din enhet.
Om du vill skapa en klientorganisation med hjälp av API:et använder du åtgärden Klientorganisationer – Skapa .
Visa och välj standardklientorganisation
Kör azsphere tenant show-selected för att kontrollera att den valda klientorganisationen ska användas som standard på den här datorn.
Om du vill ändra eller välja standardklientorganisationen kör du azsphere-klientorganisationen.
Dricks
Om du loggar ut och loggar in igen i Azure Sphere Security Service kan du uppmanas att välja standardklient. Logga in med det konto som du vill använda för att hantera dina Azure Sphere-enheter.
Lista klienter
Du kan visa en lista över tillgängliga Azure Sphere-klienter med hjälp av följande alternativ:
Kör följande kommando för att visa en lista över tillgängliga Azure Sphere-klientorganisationer.
azsphere tenant list
Om du vill visa en klientorganisation med hjälp av API:et använder du åtgärden Klientorganisationer – Hämta .
Uppdatera en befintlig klientorganisation
Du kan använda Azure Sphere CLI eller Azure Sphere Public API för att byta namn på en befintlig Azure Sphere-klientorganisation. 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.
Kör kommandot för att uppdatera en klientorganisation med hjälp av CLI:
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
Dricks
Ett meddelande kan visas om standardklientorganisationen inte är markerad. Välj den klientorganisation som krävs i listan och försök igen.
Om du vill uppdatera en klientorganisation med hjälp av API:et använder du åtgärden Klientorganisationer – Korrigering .
Ladda ned felrapport för klientorganisation
Om du vill hämta felrapporter för alla enheter i en klientorganisation använder du kommandot azsphere tenant download-error-report.