roll
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Hanterar användarroller i klientorganisationer för rollbaserad åtkomstkontroll (RBAC).
| Operation | description |
|---|---|
| addera | Lägger till en roll för en användare. |
| ta bort | Tar bort en användarroll. |
| lista | Visar en lista över användare och deras roller. |
| visa | Returnerar roller som tilldelats ett visst användarkonto. |
| show-types | Visar en lista över roller som stöds för den här klientorganisationen. |
add
Lägger till en roll till en användare.
- En administratör har fullständig åtkomst till alla enheter och åtgärder i klientorganisationen, inklusive behörighet att lägga till eller ta bort andra användare. Administratörsrollen tilldelas som standard till den användare som skapar klientorganisationen.
- En deltagare kan lägga till enheter och skapa och ändra distributioner. Programvaru- och maskinvaruutvecklare som skapar program, hanterar anslutna enheter och uppdaterar distributioner, men inte ansvarar för att hantera klientåtkomst, bör ha rollen Deltagare.
- En läsare har åtkomst till information om klientorganisationen, inklusive de enheter som påstås, distributioner och, när det är tillgängligt, eventuella felrapporteringsdata från enheterna. Den här rollen är lämplig för underhålls- och driftpersonal som ansvarar för att spåra anslutna enhetsprestanda vid slutanvändarinstallationer.
Kommentar
Det här kommandot registrerar automatiskt användarens Microsoft-konto med Azure Sphere, om de inte är registrerade ännu. Tidigare användes kommandot register-user för att registrera en ny användare med Azure Sphere. Detta görs nu automatiskt när en användare läggs till i en ny roll i en befintlig klientorganisation, och kommandot register-user är nu inaktuellt.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -u, --user | String | Anger namnet på användaren (e-postadress). |
| -r, --role | String | Anger den roll som den valda användaren ska tilldelas. Möjliga roller är: Administratör, Deltagare och Läsare. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere role add --user john@contoso.com --role Administrator
delete
Tar bort en roll från en användare i den aktuella eller valda Azure Sphere-klientorganisationen.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -u, --user | String | Anger användarens ID eller e-post för att identifiera den användare som rollen tas bort från. |
| -r, --role | Enum | Anger vilken roll som ska tas bort. Möjliga roller är: Administratör, Deltagare och Läsare. |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Kommentar
Den aktuella användarens administratörsroll kan bara tas bort av en annan administratör.
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere role delete --user bob@contoso.com --role contributor --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
lista
Visar en lista över användarroller i den aktuella eller valda klientorganisationen.
Listan trunkeras efter de första 500 posterna.
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere role list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
--------------------- -------------
Name Roles
===================================
bob@contoso.com Administrator
Contributor
--------------------- -------------
visa
Visar rollinformation för en vald användare.
Obligatoriska parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -u, --user | String | Användarnamn som ska visas (e-postadress). |
Valfria parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| -t, --tenant | GUID eller namn | Anger den klientorganisation som åtgärden ska utföras i. Åsidosätter den valda standardklientorganisationen. Du kan ange antingen klientorganisations-ID eller klientnamn. |
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere role show --user john@contoso.com --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
-------------
Roles
=============
Administrator
Contributor
-------------
show-types
Visar roller som kan tilldelas i den här klientorganisationen.
Globala parametrar
Följande globala parametrar är tillgängliga för Azure Sphere CLI:
| Parameter | Description |
|---|---|
| --felsöka | Ökar loggningsverositeten för att visa alla felsökningsloggar. Om du hittar en bugg kan du tillhandahålla utdata som genererats med flaggan --debug när du skickar en felrapport. |
| -h, --help | Skriver ut CLI-referensinformation om kommandon och deras argument och listar tillgängliga undergrupper och kommandon. |
| --only-show-errors | Visar endast fel och undertrycker varningar. |
| -o, --output | Ändrar utdataformatet. De tillgängliga utdataformaten är json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) och yaml. Som standard matar CLI ut table. Mer information om tillgängliga utdataformat finns i Utdataformat för Azure Sphere CLI-kommandon. |
| --fråga | Använder JMESPath-frågespråket för att filtrera utdata som returneras från Azure Sphere Security Services. Mer information och exempel finns i JMESPath-självstudien och Fråga azure CLI-kommandoutdata . |
| --mångordig | Skriver ut information om resurser som skapats i Azure Sphere under en åtgärd och annan användbar information. Visa fullständiga felsökningsloggar genom att köra --debug. |
Kommentar
Om du använder klassiska Azure Sphere CLI kan du läsa Globala parametrar för mer information om tillgängliga alternativ.
Exempel
azsphere role show-types
-------------
Result
=============
Administrator
-------------
Contributor
-------------
Reader
-------------