az blueprint

  • 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-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Befehle zum Verwalten von Blueprints.

Befehle

Name Beschreibung Typ Status
az blueprint artifact

Befehle zum Verwalten des Blueprintartefakts.

 Durchwahl Allgemein verfügbar
az blueprint artifact delete

Löschen sie ein Blueprintartefakt.

 Durchwahl Vorschau
az blueprint artifact list

Auflisten von Artefakten für eine bestimmte Blueprintdefinition.

 Durchwahl Vorschau
az blueprint artifact policy

Befehle zum Verwalten des Entwurfsrichtlinienzuweisungsartefaktes.

 Durchwahl Allgemein verfügbar
az blueprint artifact policy create

Erstellen sie ein Blueprint-Richtlinienartefakt.

 Durchwahl Allgemein verfügbar
az blueprint artifact policy update

Aktualisieren sie das Blueprint-Richtlinienartefakt.

 Durchwahl Allgemein verfügbar
az blueprint artifact role

Befehle zum Verwalten des Entwurfsrollenzuweisungsartefaktes.

 Durchwahl Allgemein verfügbar
az blueprint artifact role create

Erstellen eines Blueprint-Rollenartefakts.

 Durchwahl Allgemein verfügbar
az blueprint artifact role update

Aktualisieren des Blueprint-Rollenartefakts.

 Durchwahl Allgemein verfügbar
az blueprint artifact show

Rufen Sie ein Blueprintartefakt ab.

 Durchwahl Vorschau
az blueprint artifact template

Befehle zum Verwalten des Blueprint-ARM-Vorlagenartefaktes.

 Durchwahl Allgemein verfügbar
az blueprint artifact template create

Erstellen Sie ein Blueprint-Armartefakt.

 Durchwahl Allgemein verfügbar
az blueprint artifact template update

Blaupausenarmartefakt aktualisieren.

 Durchwahl Allgemein verfügbar
az blueprint assignment

Befehle zum Verwalten der Blaupausenzuweisung.

 Durchwahl Allgemein verfügbar
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 create

Erstellen Sie eine Blaupausendefinition.

 Durchwahl Vorschau
az blueprint delete

Löschen sie eine Blaupausendefinition.

 Durchwahl Vorschau
az blueprint export

Exportieren Sie eine Blueprintdefinition und Artefakte in JSON-Dateien.

 Durchwahl Allgemein verfügbar
az blueprint import

Importieren Sie eine Blueprintdefinition und Artefakte aus einer Direkty von JSON-Dateien.

 Durchwahl Allgemein verfügbar
az blueprint list

Blaupausendefinitionen auflisten.

 Durchwahl Vorschau
az blueprint publish

Veröffentlichen Sie eine neue Version der Blueprintdefinition mit den neuesten Artefakten. Veröffentlichte Blueprintdefinitionen sind unveränderlich.

 Durchwahl Vorschau
az blueprint resource-group

Befehle zum Verwalten des Ressourcengruppenartefaktes für Blueprints.

 Durchwahl Allgemein verfügbar
az blueprint resource-group add

Fügen Sie dem Blueprint ein Ressourcengruppenartefakt hinzu.

 Durchwahl Allgemein verfügbar
az blueprint resource-group list

Listenplanressourcengruppenartefakt.

 Durchwahl Allgemein verfügbar
az blueprint resource-group remove

Entfernen Sie ein Blueprint-Ressourcengruppenartefakt.

 Durchwahl Allgemein verfügbar
az blueprint resource-group show

Blaupausenressourcengruppenartefakt anzeigen.

 Durchwahl Allgemein verfügbar
az blueprint resource-group update

Aktualisieren sie das Artefakt der Blueprint-Ressourcengruppe.

 Durchwahl Allgemein verfügbar
az blueprint show

Rufen Sie eine Blaupausendefinition ab.

 Durchwahl Vorschau
az blueprint update

Aktualisieren einer Blaupausendefinition.

 Durchwahl Vorschau
az blueprint version

Befehle zum Verwalten veröffentlichter Blueprintversionen.

 Durchwahl Vorschau
az blueprint version artifact

Befehle zum Verwalten veröffentlichter Blueprintartefakte.

 Durchwahl Vorschau
az blueprint version artifact list

Auflisten von Artefakten für eine Version eines veröffentlichten Blueprints.

 Durchwahl Vorschau
az blueprint version artifact show

Zeigen Sie ein Artefakt für einen veröffentlichten Blueprint an.

 Durchwahl Vorschau
az blueprint version delete

Löschen einer veröffentlichten Version eines Blueprints.

 Durchwahl Vorschau
az blueprint version list

Listet veröffentlichte Versionen der angegebenen Blueprintdefinition auf.

 Durchwahl Vorschau
az blueprint version show

Rufen Sie eine veröffentlichte Version eines Blueprints ab.

 Durchwahl Vorschau

az blueprint create

Vorschau

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

Erstellen Sie eine Blaupausendefinition.

az blueprint create --name
                    --target-scope {managementGroup, subscription}
                    [--description]
                    [--display-name]
                    [--management-group]
                    [--parameters]
                    [--resource-groups]
                    [--subscription]

Beispiele

Erstellen eines Abonnementplans

az blueprint create --subscription MySubscription --name MyBlueprint --description "blueprint contains all artifacts" --target-scope subscription

Erstellen eines Verwaltungsgruppen-Blueprints

az blueprint create --management-group MyManagementGroup --name MyBlueprint --description "blueprint contains all artifact" --target-scope subscription

Erforderliche Parameter

--name -n

Name der Blaupausendefinition.

--target-scope

Der Bereich, in dem diese Blueprintdefinition zugewiesen werden kann.

Zulässige Werte: managementGroup, subscription

Optionale Parameter

--description

Mehrzeilige Erläuterung dieser Ressource.

--display-name

Diese Ressource wird durch eine einzeilige Zeichenfolge erläutert.

--management-group -m

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

--parameters -p

Parameter, die von dieser Blueprintdefinition benötigt werden. Dabei kann es sich um eine JSON-Zeichenfolge oder einen JSON-Dateipfad sein. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--resource-groups

Durch diese Blueprintdefinition definierte Platzhalter für Ressourcengruppen. Erwarteter Wert: json-string/@json-file. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

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

az blueprint delete --name
                    [--management-group]
                    [--subscription]
                    [--yes]

Beispiele

Löschen eines Verwaltungsgruppen-Blueprints

az blueprint delete --management-group MyManagementGroup --name MyBlueprint

Löschen eines Abonnementplans

az blueprint delete --subscription MySubscription --name MyBlueprint

Erforderliche Parameter

--name -n

Name der Blaupausendefinition.

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.

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

Exportieren Sie eine Blueprintdefinition und Artefakte in JSON-Dateien.

az blueprint export --name
                    --output-path
                    [--management-group]
                    [--subscription]
                    [--yes]

Beispiele

Exportieren einer Blueprintdefinition und Artefakte

az blueprint export --name MyBlueprint \
--output-path "path/to/blueprint/directory"

Erforderliche Parameter

--name -n

Name der zu exportierenden Blueprintdefinition.

--output-path

Der Verzeichnispfad für JSON-Definitionen der Blueprints und Artefakte. Die Blueprintdefinitionsdatei heißt "blueprint.json". Json-Dateien von Artefakten befinden sich in einem Unterverzeichnis namens Artefakten.

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.

--yes -y

Benutzerbestätigung überspringen. Wenn festgelegt, wenn das Verzeichnis nicht vorhanden ist, wird es erstellt. Wenn das Verzeichnis vorhanden ist und Inhalte enthält, werden sie überschrieben. Wenn nicht festgelegt, wird der Benutzer aufgefordert, die Berechtigung zum Fortfahren zu erhalten.

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 import

Importieren Sie eine Blueprintdefinition und Artefakte aus einer Direkty von JSON-Dateien.

az blueprint import --input-path
                    --name
                    [--management-group]
                    [--subscription]
                    [--yes]

Beispiele

Importieren einer Blueprintdefinition und Artefakte

az blueprint import --name MyBlueprint \
--input-path "path/to/blueprint/directory"

Erforderliche Parameter

--input-path

Der Verzeichnispfad für JSON-Definitionen der Blueprints und Artefakte. Die Blueprintdefinitionsdatei sollte den Namen "blueprint.json" haben. Json-Artefakte sollten sich in einem Unterverzeichnis namens Artefakte befinden.

--name -n

Name der Blaupausendefinition.

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.

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

Vorschau

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

Blaupausendefinitionen auflisten.

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

Beispiele

Auflisten von Blaupausen in einer Verwaltungsgruppe

az blueprint list --management-group MyManagementGroup

Auflisten von Blueprints in einem Abonnement

az blueprint 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 publish

Vorschau

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

Veröffentlichen Sie eine neue Version der Blueprintdefinition mit den neuesten Artefakten. Veröffentlichte Blueprintdefinitionen sind unveränderlich.

az blueprint publish --blueprint-name
                     --version
                     [--change-notes]
                     [--management-group]
                     [--subscription]

Beispiele

Veröffentlichen eines Verwaltungsgruppen-Blueprints

az blueprint publish --management-group MyManagementGroup --blueprint-name MyBlueprint --version v2

Veröffentlichen eines Abonnementplans

az blueprint publish --subscription MySubscription --blueprint-name MyBlueprint --version v2

Erforderliche Parameter

--blueprint-name

Name der Blaupausendefinition.

--version

Version der veröffentlichten Blueprintdefinition.

Optionale Parameter

--change-notes

Versionsspezifische Änderungsnotizen.

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

Vorschau

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

Rufen Sie eine Blaupausendefinition ab.

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

Beispiele

Anzeigen eines Verwaltungsgruppen-Blueprints

az blueprint show --management-group MyManagementGroup --name MyBlueprint

Anzeigen eines Abonnementplans

az blueprint show --subscription MySubscription --name MyBlueprint

Erforderliche Parameter

--name -n

Name der Blaupausendefinition.

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 update

Vorschau

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

Aktualisieren einer Blaupausendefinition.

az blueprint update --name
                    [--add]
                    [--description]
                    [--display-name]
                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                    [--management-group]
                    [--parameters]
                    [--remove]
                    [--resource-groups]
                    [--set]
                    [--subscription]
                    [--target-scope {managementGroup, subscription}]

Erforderliche Parameter

--name -n

Name der Blaupausendefinition.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--description

Mehrzeilige Erläuterung dieser Ressource.

--display-name

Diese Ressource wird durch eine einzeilige Zeichenfolge erläutert.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--management-group -m

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

--parameters -p

Parameter, die von dieser Blueprintdefinition benötigt werden. Dabei kann es sich um eine JSON-Zeichenfolge oder einen JSON-Dateipfad sein. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-groups

Durch diese Blueprintdefinition definierte Platzhalter für Ressourcengruppen. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.

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

--target-scope

Der Bereich, in dem diese Blueprintdefinition zugewiesen werden kann.

Zulässige Werte: managementGroup, subscription
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.