Freigeben über


az group deployment

Diese Befehlsgruppe ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Verwalten von Azure Resource Manager-Bereitstellungen.

Befehle

Name Beschreibung Typ Status
az group deployment cancel

Bricht eine derzeit ausgeführte Vorlagenbereitstellung ab.

Kern Veraltet
az group deployment create

Starten Sie eine Bereitstellung.

Kern Veraltet
az group deployment delete

Löscht eine Bereitstellung aus dem Bereitstellungsverlauf.

Kern Veraltet
az group deployment export

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

Kern Veraltet
az group deployment list

Rufen Sie alle Bereitstellungen für eine Ressourcengruppe ab.

Kern Veraltet
az group deployment operation

Verwalten von Bereitstellungsvorgängen.

Kern Veraltet
az group deployment operation list

Ruft alle Bereitstellungsvorgänge für eine Bereitstellung ab.

Kern Veraltet
az group deployment operation show

Rufen Sie den Vorgang einer Bereitstellung ab.

Kern Veraltet
az group deployment show

Ruft eine Bereitstellung ab.

Kern Veraltet
az group deployment validate

Überprüfen Sie, ob eine Vorlage syntaktisch korrekt ist.

Kern Veraltet
az group deployment wait

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

Kern Veraltet

az group deployment cancel

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Bricht eine derzeit ausgeführte Vorlagenbereitstellung ab.

Sie können eine Bereitstellung nur abbrechen, wenn der provisioningState akzeptiert oder ausgeführt wird. Nachdem die Bereitstellung abgebrochen wurde, wird der provisioningState auf "Canceled" festgelegt. Durch das Abbrechen einer Vorlagenbereitstellung wird die derzeit ausgeführte Vorlagenbereitstellung beendet und die Ressourcengruppe teilweise bereitgestellt.

az group deployment cancel --name
                           --resource-group

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

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 group deployment create

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Starten Sie eine Bereitstellung.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Beispiele

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

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

Erstellen Sie eine Bereitstellung aus einer lokalen Vorlage mithilfe einer lokalen Parameterdatei, einer Remoteparameterdatei und selektiven Überschreiben von Schlüssel-Wert-Paaren.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--aux-subs
Als veraltet markiert

Option "--aux-subs" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "---aux-tenants".

Hilfsabonnements, die während der Bereitstellung über Mandanten hinweg verwendet werden.

--aux-tenants

Hilfsmandanten, die während der Bereitstellung über Mandanten hinweg verwendet werden.

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

--mode

Inkrementell (nur Ressourcen zur Ressourcengruppe hinzufügen) oder "Complete" (entfernen Sie zusätzliche Ressourcen aus der Ressourcengruppe).

Zulässige Werte: Complete, Incremental
Standardwert: Incremental
--name -n

Der Bereitstellungsname. Standardname der Vorlagendatei.

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

--rollback-on-error

Der Name einer Bereitstellung, auf die ein Rollback auf fehler ausgeführt werden soll, oder verwenden Sie als Kennzeichnung, um einen Rollback auf die letzte erfolgreiche Bereitstellung durchzuführen.

--template-file -f

Ein Pfad zu einer Vorlagendatei oder Bicep-Datei im Dateisystem.

--template-uri -u

Ein URI für eine Remotevorlagendatei.

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 group deployment delete

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Löscht eine Bereitstellung aus dem Bereitstellungsverlauf.

Eine derzeit ausgeführte Vorlagenbereitstellung kann nicht gelöscht werden. Durch das Löschen einer Vorlagenbereitstellung werden die zugehörigen Bereitstellungsvorgänge entfernt. Das Löschen einer Vorlagenbereitstellung wirkt sich nicht auf den Status der Ressourcengruppe aus. Dies ist ein asynchroner Vorgang, der den Status 202 zurückgibt, bis die Vorlagenbereitstellung erfolgreich gelöscht wurde. Der Header für die Standortantwort enthält den URI, der zum Abrufen des Status des Prozesses verwendet wird. Während der Prozess ausgeführt wird, gibt ein Aufruf des URI im Location-Header den Status 202 zurück. Nach Abschluss des Vorgangs gibt der URI im Header "Speicherort" den Status 204 bei Erfolg zurück. Wenn die asynchrone Anforderung fehlgeschlagen ist, gibt der URI im Location-Header einen Statuscode auf Fehlerebene zurück.

az group deployment delete --name
                           --resource-group
                           [--no-wait]

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

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

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

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

az group deployment export --name
                           --resource-group

Beispiele

Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird. (automatisch generiert)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

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

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Rufen Sie alle Bereitstellungen für eine Ressourcengruppe ab.

az group deployment list --resource-group
                         [--filter]
                         [--top]

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--filter

Der filter, der auf den Vorgang angewendet werden soll. Sie können z. B. $filter=provisioningState eq '{state}' verwenden. Der Standardwert ist None.

--top

Die Anzahl der abzurufenden Ergebnisse. Wenn Null übergeben wird, werden alle Bereitstellungen zurückgegeben. Der Standardwert ist None.

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

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Ruft eine Bereitstellung ab.

az group deployment show --name
                         --resource-group

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

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 group deployment validate

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

Überprüfen Sie, ob eine Vorlage syntaktisch korrekt ist.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

Beispiele

Überprüfen Sie, ob eine Vorlage syntaktisch korrekt ist. (automatisch generiert)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

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.

--mode

Inkrementell (nur Ressourcen zur Ressourcengruppe hinzufügen) oder "Complete" (entfernen Sie zusätzliche Ressourcen aus der Ressourcengruppe).

Zulässige Werte: Complete, Incremental
Standardwert: Incremental
--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.

--rollback-on-error

Der Name einer Bereitstellung, auf die ein Rollback auf fehler ausgeführt werden soll, oder verwenden Sie als Kennzeichnung, um einen Rollback auf die letzte erfolgreiche Bereitstellung durchzuführen.

--template-file -f

Ein Pfad zu einer Vorlagendatei oder Bicep-Datei im Dateisystem.

--template-uri -u

Ein URI für eine Remotevorlagendatei.

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 group deployment wait

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Gruppenbereitstellung" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Bereitstellungsgruppe".

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

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

Beispiele

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

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

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

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

Erforderliche Parameter

--name -n

Der Bereitstellungsname.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

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.