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.

Kernspeicher Als veraltet markiert
az group deployment create

Startet eine Bereitstellung.

Kernspeicher Als veraltet markiert
az group deployment delete

Löscht eine Bereitstellung aus dem Bereitstellungsverlauf.

Kernspeicher Als veraltet markiert
az group deployment export

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

Kernspeicher Als veraltet markiert
az group deployment list

Rufen Sie alle Bereitstellungen für eine Ressourcengruppe ab.

Kernspeicher Als veraltet markiert
az group deployment operation

Verwalten von Bereitstellungsvorgängen.

Kernspeicher Als veraltet markiert
az group deployment operation list

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

Kernspeicher Als veraltet markiert
az group deployment operation show

Rufen Sie den Vorgang einer Bereitstellung ab.

Kernspeicher Als veraltet markiert
az group deployment show

Ruft eine Bereitstellung ab.

Kernspeicher Als veraltet markiert
az group deployment validate

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

Kernspeicher Als veraltet markiert
az group deployment wait

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

Kernspeicher Als veraltet markiert

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

Bereitstellungsname

--resource-group -g

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

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

Startet 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

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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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=WERT-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

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

Bereitstellungsname

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

Bereitstellungsname

--resource-group -g

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

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 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 auf den Vorgang anzuwendende Filter. 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

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

Bereitstellungsname

--resource-group -g

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

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 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=WERT-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

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

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

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.