az role definition

Verwalten von Rollendefinitionen.

Befehle

az role definition create

Erstellen Sie eine benutzerdefinierte Rollendefinition.

az role definition delete

Löschen einer Rollendefinition.

az role definition list

Listen Sie die Rollendefinitionen auf:

az role definition update

Aktualisieren einer Rollendefinition.

az role definition create

Erstellen Sie eine benutzerdefinierte Rollendefinition.

az role definition create --role-definition

Beispiele

Erstellen Sie eine Rolle mit schreibgeschütztem Zugriff auf Speicher- und Netzwerkressourcen und die Möglichkeit, VMs zu starten oder neu zu starten. (Bash)

az role definition create --role-definition '{
    "Name": "Contoso On-call",
    "Description": "Perform VM actions and read storage and network information.",
    "Actions": [
        "Microsoft.Compute/*/read",
            "Microsoft.Compute/virtualMachines/start/action",
            "Microsoft.Compute/virtualMachines/restart/action",
            "Microsoft.Network/*/read",
        "Microsoft.Storage/*/read",
            "Microsoft.Authorization/*/read",
        "Microsoft.Resources/subscriptions/resourceGroups/read",
        "Microsoft.Resources/subscriptions/resourceGroups/resources/read",
        "Microsoft.Insights/alertRules/*",
            "Microsoft.Support/*"
    ],
    "DataActions": [
        "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/*"
    ],
    "NotDataActions": [
        "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write"
    ],
    "AssignableScopes": ["/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
}'

Erstellen Sie eine Rolle aus einer Datei, die eine JSON-Beschreibung enthält.

az role definition create --role-definition @ad-role.json

Erforderliche Parameter

--role-definition

Beschreibung einer Rolle als JSON oder pfad zu einer Datei, die eine JSON-Beschreibung enthält.

az role definition delete

Löschen einer Rollendefinition.

az role definition delete --name
                          [--custom-role-only {false, true}]
                          [--resource-group]
                          [--scope]

Beispiele

Löschen einer Rollendefinition. (automatisch generiert)

az role definition delete --name MyRole

Erforderliche Parameter

--name -n

Der Name der Rolle.

Optionale Parameter

--custom-role-only

Nur benutzerdefinierte Rollen(vs. Build-In-Rollen).

Zulässige Werte: false, true
--resource-group -g

Verwenden Sie sie nur, wenn die Rolle oder Zuordnung auf der Ebene einer Ressourcengruppe hinzugefügt wurde.

--scope

Bereich, für den die Rollenzuweisung oder Definition gilt, z. B. /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333, /subscriptions/0b1f6471-1bf0-4dda-aec3-11112222333/resourceGroups/myGroups, or /subscriptions/0b1f6471-1bf0-4dda-aec3-111122222333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

az role definition list

Listen Sie die Rollendefinitionen auf:

az role definition list [--custom-role-only {false, true}]
                        [--name]
                        [--resource-group]
                        [--scope]

Optionale Parameter

--custom-role-only

Nur benutzerdefinierte Rollen(vs. Build-In-Rollen).

Zulässige Werte: false, true
--name -n

Der Name der Rolle.

--resource-group -g

Verwenden Sie sie nur, wenn die Rolle oder Zuordnung auf der Ebene einer Ressourcengruppe hinzugefügt wurde.

--scope

Bereich, für den die Rollenzuweisung oder Definition gilt, z. B. /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333, /subscriptions/0b1f6471-1bf0-4dda-aec3-11112222333/resourceGroups/myGroups, or /subscriptions/0b1f6471-1bf0-4dda-aec3-111122222333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

az role definition update

Aktualisieren einer Rollendefinition.

az role definition update --role-definition

Beispiele

Aktualisieren Sie eine Rolle mithilfe der Ausgabe von "az role definition list". (Bash)

az role definition update --role-definition '{
    "roleName": "Contoso On-call",
    "Description": "Perform VM actions and read storage and network information.",
    "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Authorization/roleDefinitions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "roleType": "CustomRole",
    "type": "Microsoft.Authorization/roleDefinitions",
    "Actions": [
        "Microsoft.Compute/*/read",
            "Microsoft.Compute/virtualMachines/start/action",
            "Microsoft.Compute/virtualMachines/restart/action",
            "Microsoft.Network/*/read",
        "Microsoft.Storage/*/read",
            "Microsoft.Authorization/*/read",
        "Microsoft.Resources/subscriptions/resourceGroups/read",
        "Microsoft.Resources/subscriptions/resourceGroups/resources/read",
        "Microsoft.Support/*"
        ],
        "DataActions": [
            "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/*"
    ],
    "NotDataActions": [
        "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write"
    ],
    "AssignableScopes": ["/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
}'

Erforderliche Parameter

--role-definition

Beschreibung einer vorhandenen Rolle als JSON oder pfad zu einer Datei, die eine JSON-Beschreibung enthält.