Freigeben über

az deployment sub

  • Referenz

Verwalten sie die Azure Resource Manager-Vorlagenbereitstellung im Abonnementbereich.

Befehle

Name Beschreibung Typ Status
az deployment sub cancel

Kündigen sie eine Bereitstellung im Abonnementbereich.

 Kern GA
az deployment sub create

Starten Sie eine Bereitstellung im Abonnementbereich.

 Kern GA
az deployment sub delete

Löschen sie eine Bereitstellung im Abonnementbereich.

 Kern GA
az deployment sub export

Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird.

 Kern GA
az deployment sub list

Auflisten von Bereitstellungen im Abonnementbereich.

 Kern GA
az deployment sub show

Anzeigen einer Bereitstellung im Abonnementbereich.

 Kern GA
az deployment sub validate

Überprüfen Sie, ob eine Vorlage im Abonnementbereich gültig ist.

 Kern GA
az deployment sub wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist.

 Kern GA
az deployment sub what-if

Führen Sie eine Bereitstellung What-If Vorgang im Abonnementbereich aus.

 Kern GA

az deployment sub cancel

Bearbeiten

Kündigen sie eine Bereitstellung im Abonnementbereich.

az deployment sub cancel --name

Beispiele

Kündigen sie eine Bereitstellung im Abonnementbereich.

az deployment sub cancel -n deployment01

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub create

Bearbeiten

Starten Sie eine Bereitstellung im Abonnementbereich.

Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.

az deployment sub create --location
                         [--confirm-with-what-if]
                         [--handle-extended-json-format]
                         [--name]
                         [--no-prompt {false, true}]
                         [--no-wait]
                         [--parameters]
                         [--proceed-if-no-change]
                         [--query-string]
                         [--template-file]
                         [--template-spec]
                         [--template-uri]
                         [--what-if]
                         [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                         [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Beispiele

Erstellen Sie eine Bereitstellung im Abonnementbereich aus einer Remotevorlagendatei mithilfe von Parametern aus einer lokalen JSON-Datei.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Erstellen Sie eine Bereitstellung im Abonnementbereich aus einer lokalen Vorlagendatei mithilfe von Parametern aus einer JSON-Zeichenfolge.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Erstellen Sie eine Bereitstellung im Abonnementbereich über eine lokale Vorlage, mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiver Außerkraftsetzung von Schlüssel-Wert-Paaren.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Erforderliche Parameter

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

Optionale Parameter

--confirm-with-what-if -c

Weisen Sie den Befehl an, die Bereitstellung What-If auszuführen, bevor Sie die Bereitstellung ausführen. Anschließend werden Sie aufgefordert, Ressourcenänderungen zu bestätigen, bevor sie fortgesetzt wird.

--handle-extended-json-format -j
Als veraltet markiert

Option "--handle-extended-json-format/-j" ist veraltet und wird in einer zukünftigen Version entfernt.

Unterstützung für die Behandlung erweiterter Vorlageninhalte, einschließlich mehrlineer und Kommentare in der Bereitstellung.

--name -n

Der Bereitstellungsname.

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für die ARM-Vorlage. Wenn der Wert "true" ist, wird die Aufforderung, dass Benutzer fehlende Parameter angeben müssen, ignoriert. Der Standardwert ist "false".

Zulässige Werte: false, true
Standardwert: False
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
--parameters -p

Geben Sie Parameterwerte für die Bereitstellung an.

Parameter können aus einer Datei mithilfe der @{path}-Syntax, einer JSON-Zeichenfolge oder als <KEY=VALUE> Paare bereitgestellt werden. Parameter werden in der reihenfolge ausgewertet. Wenn ein Wert also zweimal zugewiesen wird, wird der letztere Wert verwendet. Es wird empfohlen, zuerst die Parameterdatei anzugeben und dann selektiv mithilfe der KEY=WERT-Syntax außer Kraft zu setzen.

--proceed-if-no-change

Weisen Sie den Befehl an, die Bereitstellung auszuführen, wenn das What-If Ergebnis keine Ressourcenänderungen enthält. Anwendbar, wenn --confirm-with-what-if festgelegt ist.

--query-string -q

Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.

--template-file -f

Der Pfad zur Vorlagendatei oder Bicep-Datei.

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Der URI der Vorlagendatei.

--what-if -w

Weisen Sie den Befehl an, was-wäre-wenn für die Bereitstellung auszuführen.

--what-if-exclude-change-types -x

Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von What-If Ergebnissen ausgeschlossen werden sollen. Anwendbar, wenn --confirm-with-what-if festgelegt ist.

Zulässige Werte: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Das Format der What-If Ergebnisse. Gilt, wenn --confirm-with-what-if festgelegt ist.

Zulässige Werte: FullResourcePayloads, ResourceIdOnly
Standardwert: FullResourcePayloads
Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub delete

Bearbeiten

Löschen sie eine Bereitstellung im Abonnementbereich.

az deployment sub delete --name
                         [--no-wait]

Beispiele

Löschen sie eine Bereitstellung im Abonnementbereich.

az deployment sub delete -n deployment01

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

Optionale Parameter

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub export

Bearbeiten

Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird.

az deployment sub export --name

Beispiele

Exportieren Sie die Vorlage, die für eine Bereitstellung im Abonnementbereich verwendet wird.

az deployment sub export --name MyDeployment

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub list

Bearbeiten

Auflisten von Bereitstellungen im Abonnementbereich.

az deployment sub list [--filter]

Beispiele

Auflisten von Bereitstellungen im Abonnementbereich.

az deployment sub list

Optionale Parameter

--filter
Vorschau

Filterausdruck mit OData-Notation. Sie können "provisioningState eq '{state}'" verwenden, um provisioningState zu filtern. Weitere Informationen erhalten Sie unter https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub show

Bearbeiten

Anzeigen einer Bereitstellung im Abonnementbereich.

az deployment sub show --name

Beispiele

Anzeigen einer Bereitstellung im Abonnementbereich.

az deployment sub show -n deployment01

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub validate

Bearbeiten

Überprüfen Sie, ob eine Vorlage im Abonnementbereich gültig ist.

Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.

az deployment sub validate --location
                           [--handle-extended-json-format]
                           [--name]
                           [--no-prompt {false, true}]
                           [--parameters]
                           [--query-string]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]

Beispiele

Überprüfen Sie, ob eine Vorlage im Abonnementbereich gültig ist.

az deployment sub validate --location westus2 --template-file {template-file}

Überprüfen Sie, ob eine Vorlage im Abonnementbereich gültig ist. (automatisch generiert)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Erforderliche Parameter

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

Optionale Parameter

--handle-extended-json-format -j
Als veraltet markiert

Option "--handle-extended-json-format/-j" ist veraltet und wird in einer zukünftigen Version entfernt.

Unterstützung für die Behandlung erweiterter Vorlageninhalte, einschließlich mehrlineer und Kommentare in der Bereitstellung.

--name -n

Der Bereitstellungsname.

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für die ARM-Vorlage. Wenn der Wert "true" ist, wird die Aufforderung, dass Benutzer fehlende Parameter angeben müssen, ignoriert. Der Standardwert ist "false".

Zulässige Werte: false, true
Standardwert: False
--parameters -p

Geben Sie Parameterwerte für die Bereitstellung an.

Parameter können aus einer Datei mithilfe der @{path}-Syntax, einer JSON-Zeichenfolge oder als <KEY=VALUE> Paare bereitgestellt werden. Parameter werden in der reihenfolge ausgewertet. Wenn ein Wert also zweimal zugewiesen wird, wird der letztere Wert verwendet. Es wird empfohlen, zuerst die Parameterdatei anzugeben und dann selektiv mithilfe der KEY=WERT-Syntax außer Kraft zu setzen.

--query-string -q

Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.

--template-file -f

Der Pfad zur Vorlagendatei oder Bicep-Datei.

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Der URI der Vorlagendatei.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub wait

Bearbeiten

Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist.

az deployment sub wait --name
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--interval]
                       [--timeout]
                       [--updated]

Beispiele

Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist. (automatisch generiert)

az deployment sub wait --created --name MyDeployment

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

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

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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

Standardwert: False
Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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

az deployment sub what-if

Bearbeiten

Führen Sie eine Bereitstellung What-If Vorgang im Abonnementbereich aus.

Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.

az deployment sub what-if --location
                          [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                          [--name]
                          [--no-pretty-print]
                          [--no-prompt {false, true}]
                          [--parameters]
                          [--query-string]
                          [--result-format {FullResourcePayloads, ResourceIdOnly}]
                          [--template-file]
                          [--template-spec]
                          [--template-uri]

Beispiele

Führen Sie einen Bereitstellungsvorgang What-If vorgangs in einem Abonnement aus.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Führen Sie einen Bereitstellungsvorgang What-If Vorgang in einem Abonnement mit dem ResourceIdOnly-Format aus.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Führen Sie eine Bereitstellung What-If Vorgang in einem Abonnement aus, ohne das Ergebnis ziemlich zu drucken.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Erforderliche Parameter

--location -l

Der Speicherort zum Speichern der Bereitstellung What-If Vorgangsmetadaten.

Optionale Parameter

--exclude-change-types -x

Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von What-If Ergebnissen ausgeschlossen werden sollen.

Zulässige Werte: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Der Bereitstellungsname.

--no-pretty-print

Deaktivieren Sie "Pretty Print" für What-If Ergebnisse. Bei Festlegung wird der Ausgabeformattyp verwendet.

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für die ARM-Vorlage. Wenn der Wert "true" ist, wird die Aufforderung, dass Benutzer fehlende Parameter angeben müssen, ignoriert. Der Standardwert ist "false".

Zulässige Werte: false, true
Standardwert: False
--parameters -p

Geben Sie Parameterwerte für die Bereitstellung an.

Parameter können aus einer Datei mithilfe der @{path}-Syntax, einer JSON-Zeichenfolge oder als <KEY=VALUE> Paare bereitgestellt werden. Parameter werden in der reihenfolge ausgewertet. Wenn ein Wert also zweimal zugewiesen wird, wird der letztere Wert verwendet. Es wird empfohlen, zuerst die Parameterdatei anzugeben und dann selektiv mithilfe der KEY=WERT-Syntax außer Kraft zu setzen.

--query-string -q

Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.

--result-format -r

Das Format der What-If Ergebnisse.

Zulässige Werte: FullResourcePayloads, ResourceIdOnly
Standardwert: FullResourcePayloads
--template-file -f

Der Pfad zur Vorlagendatei oder Bicep-Datei.

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Der URI der Vorlagendatei.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

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