Huurder
Beheert een Azure Sphere-tenant.
Belangrijk
De opdrachten azsphere tenant download-ca-certificate
, azsphere tenant download-ca-certificate-chain
en azsphere tenant download-validation-certificate
zijn verouderd. Gebruik azsphere ca-certificate download
in plaats daarvan , azsphere ca-certificate download-chain
azsphere ca-certificate download-proof
, enazsphere ca-certificate list
.
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 tenant is om te gebruiken bij het uitvoeren van een eenmalige bewerking die u niet ongedaan kunt maken, zoals het claimen van het apparaat.
Bewerking | Beschrijving |
---|---|
Maken | Hiermee maakt u een nieuwe tenant. |
download-error-report | Retourneert foutinformatie voor apparaten binnen de huidige tenant. |
Lijst | Een lijst met de beschikbare Azure Sphere-tenants. |
Selecteer | Selecteert de standaard Azure Sphere-tenant die op deze computer moet worden gebruikt. |
weergeven geselecteerd | Toont de standaard Azure Sphere-tenant voor deze computer. |
Update | Updates de details van de tenant, 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 nog een 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 select 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 zonder dat er een apparaat 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 | Beschrijving |
---|---|---|
-n, --name | Tekenreeks | Hiermee geeft u een naam voor de tenant. 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. |
Optionele parameters
Parameter | Type | Beschrijving |
---|---|---|
-d, --device | Tekenreeks | Hiermee geeft u het apparaat waarop de opdracht moet worden uitgevoerd wanneer meerdere apparaten zijn gekoppeld. Deze parameter is vereist wanneer meerdere apparaten zijn gekoppeld. Het apparaat dat momenteel is gekoppeld, 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-extra | Booleaanse | 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 | Hiermee schakelt u de bevestigingsprompt van de gebruiker uit. |
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
Parameter | Beschrijving |
---|---|
--Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
-h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
--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 voert de CLI uit table . Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
--Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
--Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
azsphere tenant create --name MyTenant
Gebruik de --force-additional
parameters en --disable-confirm-prompt
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
Nadat u een tenant hebt gemaakt, moet u azsphere tenant select uitvoeren 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.
Opmerking
Het kan tot 24 uur duren voordat onlangs gemelde gebeurtenissen beschikbaar zijn om te downloaden. Zie Foutgegevens verzamelen en interpreteren voor meer informatie.
Optionele parameters
Parameter | Type | Beschrijving |
---|---|---|
--Bestemming | Tekenreeks | 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. Overschrijft 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 | Beschrijving |
---|---|
--Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
-h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
--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 voert de CLI uit table . Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
--Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
--Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Lijst
Een lijst met Azure Sphere-tenants.
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
Parameter | Beschrijving |
---|---|
--Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
-h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
--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 voert de CLI uit table . Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
--Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
--Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Selecteer
Selecteert 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 | Beschrijving |
---|---|---|
-t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
---|---|
--Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
-h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
--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 voert de CLI uit table . Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
--Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
--Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
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 selecteren .
Globale parameters
De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:
Parameter | Beschrijving |
---|---|
--Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
-h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
--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 voert de CLI uit table . Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
--Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
--Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Update
Updates de details van een tenant, zoals de naam van de tenant.
Vereiste parameters
Parameter | Type | Beschrijving |
---|---|---|
-n, --new-name | Tekenreeks | Hiermee geeft u een nieuwe naam voor de tenant. 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. |
Optionele parameters
Parameter | Type | Beschrijving |
---|---|---|
-t, --tenant | GUID of naam | Hiermee geeft u de tenant op waarin deze bewerking moet worden uitgevoerd. Overschrijft 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 | Beschrijving |
---|---|
--Debug | Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport. |
-h, --help | Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten. |
--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 voert de CLI uit table . Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen. |
--Query | Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden. |
--Uitgebreide | Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Opmerking
Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u Globale parameters voor meer informatie over beschikbare opties.
Voorbeeld
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.