az blueprint assignment

  • Referenz

Hinweis

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 einen Az Blueprint-Zuweisungsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Befehle zum Verwalten der Blaupausenzuweisung.

Befehle

Name Beschreibung Typ Status
az blueprint assignment create

Erstellen Sie eine Blaupausenzuweisung.

 Durchwahl Allgemein verfügbar
az blueprint assignment delete

Löschen sie eine Blaupausenzuweisung.

 Durchwahl Vorschau
az blueprint assignment list

Auflisten von Blaupausenzuweisungen innerhalb eines Abonnements.

 Durchwahl Vorschau
az blueprint assignment show

Rufen Sie eine Blaupausenzuweisung ab.

 Durchwahl Vorschau
az blueprint assignment update

Aktualisieren einer Blaupausenzuweisung.

 Durchwahl Allgemein verfügbar
az blueprint assignment wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Blueprint-Zuordnung erfüllt ist.

 Durchwahl Allgemein verfügbar
az blueprint assignment who

Get Blueprint Servie Principal Name objectId.

 Durchwahl Vorschau

az blueprint assignment create

Erstellen Sie eine Blaupausenzuweisung.

az blueprint assignment create --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Beispiele

Zuordnung mit vom System zugewiesener verwalteter Identität

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \

Zuweisung mit vom Benutzer zugewiesener verwalteter Identität

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \

Erforderliche Parameter

--name -n

Name der Blueprint-Zuordnung.

Optionale Parameter

--blueprint-version

Ressourcen-ID der veröffentlichten Version einer Blueprintdefinition.

--description

Mehrzeilige Erläuterung dieser Ressource.

--display-name

Diese Ressource wird durch eine einzeilige Zeichenfolge erläutert.

--identity-type

Typ der verwalteten Identität.

Zulässige Werte: None, SystemAssigned, UserAssigned
Standardwert: SystemAssigned
--location -l

Position Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--locks-excluded-principals

Liste der AAD-Prinzipale, die von Blueprintsperren ausgeschlossen sind. Bis zu 5 Prinzipale sind zulässig.

--locks-mode

Sperrmodus.

Zulässige Werte: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Verwenden Sie die Verwaltungsgruppe für den Zielbereich der Blueprint-Zuordnung. Sie ist für die zukünftige Verwendung reserviert. Verwenden Sie stattdessen --subscription.

--parameters -p

Werte des Blueprint-Zuordnungsparameters. Dabei kann es sich um eine JSON-Zeichenfolge oder einen JSON-Dateipfad sein.

--resource-group-value

Key=Value-Paare für eine Ressourcengruppe. Schlüssel umfassen "artifact_name"(erforderlich), "name", "location".

--subscription -s

Verwenden Sie das Abonnement für den Zielbereich der Blueprintzuweisung. Standardmäßige Susbcription wird verwendet, wenn die Option nicht angegeben ist.

--user-assigned-identity

Die vom Benutzer zugewiesene verwaltete Identität, die der Ressource zugeordnet ist.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az blueprint assignment delete

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen sie eine Blaupausenzuweisung.

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Beispiele

Löschen einer Zuweisung

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

Erforderliche Parameter

--name -n

Name der Blueprint-Zuordnung.

Optionale Parameter

--delete-behavior

Wenn deleteBehavior=all, werden die ressourcen, die von der Blueprintzuordnung erstellt wurden, gelöscht.

Zulässige Werte: all, none
--management-group -m

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

--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.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az blueprint assignment list

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten von Blaupausenzuweisungen innerhalb eines Abonnements.

az blueprint assignment list [--management-group]
                             [--max-items]
                             [--next-token]
                             [--subscription]

Beispiele

Auflisten von Aufgaben

az blueprint assignment list --subscription MySubscription

Optionale Parameter

--management-group -m

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

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert im --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

--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.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az blueprint assignment show

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Rufen Sie eine Blaupausenzuweisung ab.

az blueprint assignment show --name
                             [--management-group]
                             [--subscription]

Beispiele

Anzeigen einer Aufgabe

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

Erforderliche Parameter

--name -n

Name der Blueprint-Zuordnung.

Optionale Parameter

--management-group -m

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

--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.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az blueprint assignment update

Aktualisieren einer Blaupausenzuweisung.

az blueprint assignment update --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Erforderliche Parameter

--name -n

Name der Blueprint-Zuordnung.

Optionale Parameter

--blueprint-version

Ressourcen-ID der veröffentlichten Version einer Blueprintdefinition.

--description

Mehrzeilige Erläuterung dieser Ressource.

--display-name

Diese Ressource wird durch eine einzeilige Zeichenfolge erläutert.

--identity-type

Typ der verwalteten Identität.

Zulässige Werte: None, SystemAssigned, UserAssigned
--location -l

Position Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--locks-excluded-principals

Liste der AAD-Prinzipale, die von Blueprintsperren ausgeschlossen sind. Bis zu 5 Prinzipale sind zulässig.

--locks-mode

Sperrmodus.

Zulässige Werte: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Verwenden Sie die Verwaltungsgruppe für den Zielbereich der Blueprint-Zuordnung. Sie ist für die zukünftige Verwendung reserviert. Verwenden Sie stattdessen --subscription.

--parameters -p

Werte des Blueprint-Zuordnungsparameters. Dabei kann es sich um eine JSON-Zeichenfolge oder einen JSON-Dateipfad sein.

--resource-group-value

Key=Value-Paare für eine Ressourcengruppe. Schlüssel umfassen "artifact_name"(erforderlich), "name", "location".

--subscription -s

Verwenden Sie das Abonnement für den Zielbereich der Blueprintzuweisung. Standardmäßige Susbcription wird verwendet, wenn die Option nicht angegeben ist.

--user-assigned-identity

Die vom Benutzer zugewiesene verwaltete Identität, die der Ressource zugeordnet ist.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az blueprint assignment wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Blueprint-Zuordnung erfüllt ist.

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Beispiele

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Blueprint-Zuordnung erfolgreich bereitgestellt wurde.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

Erforderliche Parameter

--name -n

Name der Blueprint-Zuordnung.

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--management-group -m

Verwenden Sie die Verwaltungsgruppe für den Zielbereich der Blueprint-Zuordnung. Sie ist für die zukünftige Verwendung reserviert. Verwenden Sie stattdessen --subscription.

--subscription -s

Verwenden Sie das Abonnement für den Zielbereich der Blueprintzuweisung. Standardmäßige Susbcription wird verwendet, wenn die Option nicht angegeben ist.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az blueprint assignment who

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Get Blueprint Servie Principal Name objectId.

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

Beispiele

ABRUFEN der SPN-Objekt-ID

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

Erforderliche Parameter

--name -n

Name der Blueprint-Zuordnung.

Optionale Parameter

--management-group -m

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

--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.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.