role
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 gebruikersrollen in tenants voor op rollen gebaseerd toegangsbeheer (RBAC).
| Operation | beschrijving |
|---|---|
| add | Voegt een rol toe voor een gebruiker. |
| verwijderen | Hiermee verwijdert u een gebruikersrol. |
| lijst | Geeft een lijst weer met gebruikers en hun rollen. |
| tonen | Hiermee worden rollen geretourneerd die zijn toegewezen aan een bepaald gebruikersaccount. |
| show-types | Geeft een lijst weer met rollen die worden ondersteund voor deze tenant. |
add
Voegt een rol toe aan een gebruiker.
- Een beheerder heeft volledige toegang tot alle apparaten en bewerkingen binnen de tenant, inclusief de machtiging om andere gebruikers toe te voegen of te verwijderen. De beheerdersrol wordt standaard toegewezen aan de gebruiker die de tenant maakt.
- Een inzender kan apparaten toevoegen en implementaties maken en wijzigen. Software- en hardwareontwikkelaars die toepassingen maken, verbonden apparaten beheren en implementaties bijwerken, maar die niet verantwoordelijk zijn voor het beheren van tenanttoegang, moeten de rol Inzender hebben.
- Een lezer heeft toegang tot informatie over de tenant, waaronder de geclaimde apparaten, implementaties en, indien beschikbaar, eventuele foutrapportagegegevens van de apparaten. Deze rol is geschikt voor onderhouds- en operationele medewerkers die verantwoordelijk zijn voor het bijhouden van de prestaties van verbonden apparaten bij installaties van eindgebruikers.
Notitie
Met deze opdracht wordt het Microsoft-account van de gebruiker automatisch geregistreerd bij Azure Sphere als deze nog niet zijn geregistreerd. Voorheen werd de opdracht Register-user gebruikt om een nieuwe gebruiker te registreren bij Azure Sphere. Dit wordt nu automatisch gedaan wanneer u een gebruiker toevoegt aan een nieuwe rol binnen een bestaande tenant en de opdracht Register-user is nu afgeschaft.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -u, --user | String | Hiermee geeft u de naam van de gebruiker (e-mailadres). |
| -r, --role | String | Hiermee geeft u de rol op die moet worden toegewezen aan de geselecteerde gebruiker. Mogelijke rollen zijn: Beheerder, Inzender en Lezer. |
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 role add --user john@contoso.com --role Administrator
delete
Hiermee verwijdert u een rol van een gebruiker in de huidige of geselecteerde Azure Sphere-tenant.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -u, --user | String | Hiermee geeft u de id of het e-mailadres van de gebruiker op om de gebruiker te identificeren van wie de rol wordt verwijderd. |
| -r, --role | Enum | Hiermee geeft u de rol die moet worden verwijderd. Mogelijke rollen zijn: Beheerder, Inzender en Lezer. |
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. |
Notitie
De beheerdersrol van de huidige gebruiker kan alleen worden verwijderd door een andere beheerder.
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 role delete --user bob@contoso.com --role contributor --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
lijst
Geeft een lijst weer met gebruikersrollen in de huidige of geselecteerde tenant.
De lijst wordt afgekapt na de eerste 500 vermeldingen.
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 role list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
--------------------- -------------
Name Roles
===================================
bob@contoso.com Administrator
Contributor
--------------------- -------------
weergeven
Geeft rolgegevens weer voor een geselecteerde gebruiker.
Vereiste parameters
| Parameter | Type | Description |
|---|---|---|
| -u, --user | String | De gebruikersnaam die moet worden weergegeven (e-mailadres). |
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 role show --user john@contoso.com --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
-------------
Roles
=============
Administrator
Contributor
-------------
show-types
Geeft rollen weer die kunnen worden toegewezen in deze tenant.
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 role show-types
-------------
Result
=============
Administrator
-------------
Contributor
-------------
Reader
-------------