Tenants beheren
Belangrijk
Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.
Een Azure Sphere-tenant biedt een veilige manier voor uw organisatie om de Azure Sphere-apparaten van de organisatie op afstand te beheren, geïsoleerd van de apparaten van andere klanten. Uw organisatie moet een Azure Sphere-tenant maken en vervolgens elk apparaat van die tenant claimen, zodat u deze apparaten op afstand en op een veilige manier kunt beheren.
Vereisten
- Installeer de Azure Sphere SDK voor Windows of voor Linux.
- U moet een niet-claimapparaat hebben dat nog niet eerder is gebruikt om een tenant te maken.
Een Azure Sphere-tenant maken
Een Azure Sphere-tenant isoleert uw Azure Sphere-apparaten en biedt een manier om toepassingen te organiseren en te implementeren. Aan het account waarmee de tenant wordt gemaakt, wordt automatisch de rol van beheerder voor de tenant toegewezen.
Tip
- Zodra een tenant is gemaakt, kan deze niet worden verwijderd en kunnen apparaten niet worden gemigreerd tussen tenants. Als uw team of organisatie al een Azure Sphere-tenant heeft, kunt u overwegen om er toegang toe te vragen in plaats van een extra tenant te maken.
Een Azure Sphere-tenant maken:
Verbind een Azure Sphere-apparaat met uw computer via USB.
Open een Azure Sphere CLI met behulp van PowerShell, Windows-opdrachtprompt of Linux-opdrachtshell.
Meld u aan bij de CLI en volg de instructies hier.
Voer de volgende opdracht in om de tenant te maken:
azsphere tenant create --name <tenant-name or tenant-ID>Vervang <de naam> van de tenant door een naam die andere gebruikers kunnen herkennen, zoals Contoso Ltd of Contoso Dishwasher Division. Wanneer u uw tenant een naam krijgt, gebruikt u alleen alfanumerieke tekens en spaties. Als u spaties opneemt, plaatst u de naam tussen aanhalingstekens. De naam mag niet beginnen met een spatie of langer dan 50 tekens. Speciale tekens zijn niet toegestaan. Namen zijn hoofdlettergevoelig.
Wanneer u een tenant maakt, registreert de Azure Sphere-beveiligingsservice de apparaat-id van het gekoppelde apparaat. Elke apparaat-id kan worden gebruikt om slechts één Azure Sphere-tenant te maken.
Als uw account al toegang heeft tot een Azure Sphere-tenant, mislukt de opdracht, waarbij u wordt geadviseerd de bestaande tenant te gebruiken. Als u zeker weet dat u een nieuwe tenant wilt maken, kunt u de --force-additional parameter gebruiken om af te dwingen dat een nieuwe Azure Sphere-tenant wordt gemaakt.
De opdracht azsphere tenant create maakt een tenant, maar claimt het apparaat niet in de tenant. Zie Uw apparaat claimen voor meer informatie.
Als u een tenant wilt maken met behulp van de API, gebruikt u de bewerking Tenants - Maken .
Standaardtenant weergeven en selecteren
Voer azsphere-tenant show-selected uit om te controleren of de geselecteerde tenant moet worden gebruikt als de standaardinstelling op deze pc.
Als u de standaardtenant wilt wijzigen of selecteren, voert u azsphere-tenant selecteren uit.
Tip
Als u zich afmeldt en weer aanmeldt bij de Azure Sphere-beveiligingsservice, wordt u mogelijk gevraagd om de standaardtenant te selecteren. Zorg ervoor dat u zich aanmeldt met het account dat u wilt gebruiken om uw Azure Sphere-apparaten te beheren.
Tenants vermelden
U kunt de beschikbare Azure Sphere-tenants weergeven met behulp van de volgende opties:
Voer de volgende opdracht uit om de beschikbare Azure Sphere-tenants weer te geven.
azsphere tenant list
Als u een tenant wilt weergeven met behulp van de API, gebruikt u de bewerking Tenants - Ophalen .
Een bestaande tenant bijwerken
U kunt de Azure Sphere CLI of de openbare API van Azure Sphere gebruiken om de naam van een bestaande Azure Sphere-tenant te wijzigen. Gebruik alfanumerieke tekens als u de tenant een naam geeft. Speciale tekens zijn niet toegestaan. De naam mag niet langer zijn dan 50 tekens en is hoofdlettergevoelig.
Voer de opdracht uit om een tenant bij te werken met behulp van de CLI:
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
Tip
Er kan een bericht worden weergegeven als de standaardtenant niet is geselecteerd. Selecteer de vereiste tenant in de lijst en voer de opdracht opnieuw uit.
Als u een tenant wilt bijwerken met behulp van de API, gebruikt u de bewerking Tenants - Patch .
Foutrapport voor tenant downloaden
Gebruik de opdracht azsphere tenant download-error-report om foutrapporten te verkrijgen voor alle apparaten binnen een tenant.