Tenants beheren
Een Azure Sphere-tenant biedt uw organisatie een veilige manier om de Azure Sphere-apparaten op afstand te beheren in isolatie van de apparaten van andere klanten. Uw organisatie moet een Azure Sphere-tenant maken en vervolgens elk van de bijbehorende apparaten in die tenant claimen, zodat u deze apparaten op afstand en veilig kunt beheren.
Voorwaarden
- Installeer de Azure Sphere SDK voor Windows of voor Linux.
- U moet een niet-geclaimd apparaat 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 toegang aan te vragen in plaats van een extra tenant te maken.
Een Azure Sphere-tenant maken:
Sluit een Azure Sphere-apparaat via USB aan op uw computer.
Open een Azure Sphere CLI met behulp van PowerShell, Windows-opdrachtprompt of Linux-opdrachtshell en voer de volgende opdracht in:
azsphere tenant create --name <tenant-name or tenant-ID>Vervang tenantnaam> door <een naam die andere gebruikers kunnen herkennen, zoals 'Contoso Ltd' of 'Contoso Dishwasher Division'. Wanneer u uw tenant een naam geeft, 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 meer 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.
U kunt de --force-additional parameter gebruiken om af te dwingen dat een nieuwe Azure Sphere-tenant wordt gemaakt. Gebruik deze opdracht alleen als u zeker weet dat u het huidige account wilt gebruiken om een nieuwe Azure Sphere-tenant te maken met behulp van het gekoppelde apparaat. Een apparaat dat eerder is gebruikt om een Azure Sphere-tenant te maken, kan niet worden gebruikt om een nieuwe tenant te maken.
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 select uit.
Tip
Als u zich afmeldt en zich opnieuw aanmeldt bij de Azure Sphere-beveiligingsservice, wordt u mogelijk gevraagd de standaardtenant te selecteren. Meld u aan met het account dat u wilt gebruiken om uw Azure Sphere-apparaten te beheren.
Tenants weergeven
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 bij het benoemen van uw tenant. 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 .
Foutenrapport voor tenant downloaden
Als u foutrapporten wilt ophalen voor alle apparaten binnen een tenant, gebruikt u de opdracht azsphere tenant download-error-report .