Freigeben über

az blueprint artifact role

  • Breaking Change

Note

Diese Referenz ist Teil der Blueprint-Erweiterung für die Azure CLI (Version 2.50.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal eine az Blueprint-Artefaktrolle Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Blaupausen und zugehörige Befehle werden ab Juli 2026 nicht mehr unterstützt. Kunden werden ermutigt, auf Vorlagenspezifikationen und Bereitstellungsstapel umzusteigen, um ihre Szenarien über dieses Datum hinaus zu unterstützen. Die Migrationsdokumentation ist unter https://v4.hkg1.meaqua.org/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Diese Befehlsgruppe ist implizit veraltet, da die Befehlsgruppe "az blueprint" veraltet ist und in einer zukünftigen Version entfernt wird.

Befehle zum Verwalten des Entwurfsrollenzuweisungsartefaktes.

Befehle

Name Beschreibung Typ Status
az blueprint artifact role create

Erstellen eines Blueprint-Rollenartefakts.

 Extension GA
az blueprint artifact role update

Aktualisieren des Blueprint-Rollenartefakts.

 Extension GA

az blueprint artifact role create

Breaking Change

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "az blueprint" veraltet ist und in einer zukünftigen Version entfernt wird. Blaupausen und zugehörige Befehle werden ab Juli 2026 nicht mehr unterstützt. Kunden werden ermutigt, auf Vorlagenspezifikationen und Bereitstellungsstapel umzusteigen, um ihre Szenarien über dieses Datum hinaus zu unterstützen. Die Migrationsdokumentation ist unter https://v4.hkg1.meaqua.org/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Erstellen eines Blueprint-Rollenartefakts.

az blueprint artifact role create --artifact-name
                                  --blueprint-name
                                  --principal-ids
                                  --role-definition-id
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Beispiele

Erstellen eines Rollenartefakts

az blueprint artifact role create \
--blueprint-name MyBlueprint --artifact-name MyRole --role-definition-id \
"/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000" \
--principal-ids "[parameters('[Usergrouporapplicationname]:MyRoleAssignmentName')]"

Erforderliche Parameter

--artifact-name

Name des Blueprintartefakts.

--blueprint-name

Name der Blaupausendefinition.

--principal-ids

Array von Benutzer- oder Gruppenidentitäten in Azure Active Directory oder ein Verweis auf den entsprechenden Parameter in Blueprint Definiton. Die roleDefinition gilt für jede Identität.

--role-definition-id

Die vollständige Rollendefinitions-ID. Nur integrierte Rollen werden unterstützt.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--depends-on

Artefakte, die vor dem angegebenen Artefakt bereitgestellt werden müssen.

--description

Beschreibung des Blueprintartefakts.

--display-name

Anzeigename dieses Artefakts.

--management-group -m

Verwenden Sie die Verwaltungsgruppe für den Umfang des Blueprints.

Eigenschaft Wert
Parametergruppe: Resource_scope Arguments
--resource-group-art

Name des Ressourcengruppenartefaktes, dem die Richtlinie zugewiesen wird.

--subscription -s

Verwenden Sie das Abonnement für den Umfang des Blueprints. Wenn "-management-group" nicht angegeben ist, wird der Wert "-subscription" oder das Standardabonnement als Bereich verwendet.

Eigenschaft Wert
Parametergruppe: Resource_scope Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az blueprint artifact role update

Breaking Change

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "az blueprint" veraltet ist und in einer zukünftigen Version entfernt wird. Blaupausen und zugehörige Befehle werden ab Juli 2026 nicht mehr unterstützt. Kunden werden ermutigt, auf Vorlagenspezifikationen und Bereitstellungsstapel umzusteigen, um ihre Szenarien über dieses Datum hinaus zu unterstützen. Die Migrationsdokumentation ist unter https://v4.hkg1.meaqua.org/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Aktualisieren des Blueprint-Rollenartefakts.

az blueprint artifact role update --artifact-name
                                  --blueprint-name
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Beispiele

Aktualisieren eines Rollenartefakts

az blueprint artifact role update \
--blueprint-name MyBlueprint --artifact-name MyRole --display-name "My Big Role"

Erforderliche Parameter

--artifact-name

Name des Blueprintartefakts.

--blueprint-name

Name der Blaupausendefinition.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--depends-on

Artefakte, die vor dem angegebenen Artefakt bereitgestellt werden müssen. Verwenden Sie "---depends-on" ohne Werte, um Abhängigkeiten zu entfernen.

--description

Beschreibung des Blueprintartefakts.

--display-name

Anzeigename dieses Artefakts.

--management-group -m

Verwenden Sie die Verwaltungsgruppe für den Umfang des Blueprints.

Eigenschaft Wert
Parametergruppe: Resource_scope Arguments
--resource-group-art

Name des Ressourcengruppenartefaktes, dem die Richtlinie zugewiesen wird.

--subscription -s

Verwenden Sie das Abonnement für den Umfang des Blueprints. Wenn "-management-group" nicht angegeben ist, wird der Wert "-subscription" oder das Standardabonnement als Bereich verwendet.

Eigenschaft Wert
Parametergruppe: Resource_scope Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False