tenant
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.
Hiermee beheert u een Azure Sphere-tenant.
Belangrijk
De opdrachten azsphere tenant download-ca-certificate, azsphere tenant download-ca-certificate-chainen azsphere tenant download-validation-certificate zijn verouderd. Gebruik azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proofen azsphere ca-certificate list in plaats daarvan.
In de Azure Sphere CLI wordt de standaardtenant niet automatisch geselecteerd wanneer een tenant wordt gemaakt. U moet de opdracht azsphere tenant select uitvoeren om de standaardtenant te selecteren die moet worden gebruikt voor de huidige gebruiker op de pc. Dit is om ervoor te zorgen dat de standaardtenant de juiste is die moet worden gebruikt bij het uitvoeren van een eenmalige bewerking die u niet ongedaan kunt maken, zoals het claimen van het apparaat.
| Operation | Omschrijving |
|---|---|
| create | Hiermee maakt u een nieuwe tenant. |
| download-error-report | Retourneert foutinformatie voor apparaten binnen de huidige tenant. |
| lijst | Toont de beschikbare Azure Sphere-tenants. |
| selecteren | Hiermee selecteert u de standaard-Azure Sphere-tenant die u op deze computer wilt gebruiken. |
| weergeven geselecteerd | Toont de standaard Azure Sphere-tenant voor deze computer. |
| update | Hiermee worden de gegevens van de tenant bijgewerkt, zoals de naam van de tenant. |
maken
Hiermee maakt u een nieuwe Azure Sphere-tenant. Er is een gekoppeld apparaat vereist om deze opdracht uit te voeren. Zie Een Azure Sphere-tenant maken voor meer informatie.
Als u al een tenant hebt en zeker weet dat u een andere tenant wilt, gebruikt u de --force-additional parameter. Op dit moment kunt u een Azure Sphere-tenant niet verwijderen.
Zodra de tenant is gemaakt, voert u azsphere-tenant uit om de standaardtenant te selecteren die moet worden gebruikt voor de huidige gebruiker op deze pc. U kunt rollen toevoegen voor gebruikers in de huidige Azure Sphere-tenant met behulp van de opdracht azsphere role add .
De opdracht azsphere tenant create werkt met een lokaal gekoppeld Azure Sphere-apparaat. Als u de opdracht probeert uit te voeren zonder een apparaat dat is gekoppeld, krijgt u een foutmelding. De apparaat-id wordt vastgelegd wanneer u een tenant maakt en er kan slechts één tenant per apparaat worden gemaakt.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -n, --name | String | Hiermee geeft u een naam voor de tenant. 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. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -d, --device | String | Hiermee geeft u het apparaat op waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer er meerdere apparaten zijn gekoppeld. Het momenteel gekoppelde apparaat 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. |
| --force-additional | Booleaanse waarde | Dwingt het maken van een nieuwe Azure Sphere-tenant af. 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. |
| --disable-confirm-prompt | Booleaanse waarde | Hiermee wordt de bevestigingsprompt van de gebruiker uitgeschakeld. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --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 is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere tenant create --name MyTenant
Gebruik de --force-additional en --disable-confirm-prompt parameters als u zeker weet dat u dit 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.
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.
Tip
Zodra u een tenant hebt gemaakt, moet u ervoor zorgen dat u azsphere-tenant selecteert om de standaardtenant te selecteren die moet worden gebruikt voor de huidige gebruiker op deze pc.
download-error-report
Retourneert informatie over fouten die zijn gerapporteerd door apparaten binnen de huidige tenant.
Met deze opdracht worden gebeurtenisgegevens opgehaald uit de Azure Sphere Security Service-cloud en is geen fysieke verbinding met een bepaald apparaat vereist. De opdracht azsphere tenant download-error-report werkt in de context van de huidige tenant en retourneert foutrapporten voor alle apparaten binnen die tenant.
Notitie
Het kan tot 24 uur duren voordat onlangs gerapporteerde gebeurtenissen beschikbaar zijn om te downloaden. Zie Foutgegevens verzamelen en interpreteren voor meer informatie.
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| --bestemming | String | Hiermee geeft u het pad en de bestandsnaam van het uitvoerbestand. |
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u 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 | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --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 is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
lijst
Toont Azure Sphere-tenants.
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --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 is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Selecteer
Hiermee selecteert u de standaard Azure Sphere-tenant die moet worden gebruikt voor de huidige gebruiker op deze pc.
Als u de huidige standaardtenant wilt weergeven, gebruikt u azsphere tenant show-selected.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u 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 | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --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 is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
weergeven geselecteerd
Geeft de details weer van de standaard Azure Sphere-tenant voor de huidige gebruiker op deze pc.
Dit is de tenant die is geselecteerd met de opdracht azsphere tenant select .
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --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 is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
update
Hiermee worden de gegevens van een tenant bijgewerkt, zoals de naam van de tenant.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -n, --nieuwe-naam | String | Hiermee geeft u een nieuwe naam voor de tenant. 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. |
Optionele parameters
| Parameter | Type | Description |
|---|---|---|
| -t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Hiermee overschrijft u 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 | Description |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd. |
| -h, --help | Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken. |
| --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 is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
| --vraag | Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden. |
| --verbose | Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing. |
Notitie
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.
Opmerking
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Tip
Als u geen standaardtenant hebt geselecteerd, wordt een lijst met beschikbare tenants weergegeven. Stel uw standaardtenant in door een van de opties te selecteren.