az deployment group
Verwalten sie die Azure Resource Manager-Vorlagenbereitstellung in der Ressourcengruppe.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az deployment group cancel |
Abbrechen einer Bereitstellung in der Ressourcengruppe. |
Kernspeicher | Allgemein verfügbar |
az deployment group create |
Starten Sie eine Bereitstellung in der Ressourcengruppe. |
Kernspeicher | Allgemein verfügbar |
az deployment group delete |
Löschen sie eine Bereitstellung in der Ressourcengruppe. |
Kernspeicher | Allgemein verfügbar |
az deployment group export |
Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird. |
Kernspeicher | Allgemein verfügbar |
az deployment group list |
Auflisten von Bereitstellungen in der Ressourcengruppe. |
Kernspeicher | Allgemein verfügbar |
az deployment group show |
Anzeigen einer Bereitstellung in der Ressourcengruppe. |
Kernspeicher | Allgemein verfügbar |
az deployment group validate |
Überprüfen Sie, ob eine Vorlage in der Ressourcengruppe gültig ist. |
Kernspeicher | Allgemein verfügbar |
az deployment group wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist. |
Kernspeicher | Allgemein verfügbar |
az deployment group what-if |
Führen Sie einen Bereitstellungs-What-If-Vorgang im Ressourcengruppenbereich aus. |
Kernspeicher | Allgemein verfügbar |
az deployment group cancel
Abbrechen einer Bereitstellung in der Ressourcengruppe.
az deployment group cancel --name
--resource-group
Beispiele
Abbrechen einer Bereitstellung in der Ressourcengruppe.
az deployment group cancel -g testrg -n deployment01
Erforderliche Parameter
Bereitstellungsname
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group create
Starten Sie eine Bereitstellung in der Ressourcengruppe.
Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.
az deployment group create --resource-group
[--aux-subs]
[--aux-tenants]
[--confirm-with-what-if]
[--handle-extended-json-format]
[--mode {Complete, Incremental}]
[--name]
[--no-prompt {false, true}]
[--no-wait]
[--parameters]
[--proceed-if-no-change]
[--query-string]
[--rollback-on-error]
[--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 in der Ressourcengruppe aus einer Remotevorlagendatei mithilfe von Parametern aus einer lokalen JSON-Datei.
az deployment group create --resource-group testrg --name rollout01 \
--template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Erstellen Sie eine Bereitstellung in der Ressourcengruppe aus einer lokalen Vorlagendatei mithilfe von Parametern aus einer JSON-Zeichenfolge.
az deployment group create --resource-group testrg --name rollout01 \
--template-file azuredeploy.json \
--parameters '{ \"policyName\": { \"value\": \"policy2\" } }'
Erstellen Sie eine Bereitstellung in der Ressourcengruppe aus einer lokalen Vorlagendatei mithilfe von Parametern aus einer Arrayzeichenfolge.
az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'
Erstellen Sie eine Bereitstellung in der Ressourcengruppe aus einer lokalen Vorlage, mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiver Außerkraftsetzung von Schlüssel-Wert-Paaren.
az deployment group create --resource-group testrg --name rollout01 \
--template-file azuredeploy.json --parameters @params.json \
--parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json
Erstellen einer Bereitstellung im Ressourcengruppenbereich anhand einer Vorlagenspezifikation
az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"
Erstellen einer Bereitstellung im Ressourcengruppenbereich aus einer bicepparam-Parameterdatei
az deployment group create --resource-group testrg --parameters parameters.bicepparam
Erstellen einer Bereitstellung in Ressourcengruppen über Mandanten hinweg
az deployment group create --resource-group testrg --name rollout01 \
--template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02
Erforderliche Parameter
Die Ressourcengruppe, unter der die Bereitstellung erstellt werden soll.
Optionale Parameter
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.
Hilfsmandanten, die während der Bereitstellung über Mandanten hinweg verwendet werden.
Weisen Sie den Befehl an, die Bereitstellungs-Was-Wenn auszuführen, bevor Sie die Bereitstellung ausführen. Anschließend werden Sie aufgefordert, Ressourcenänderungen zu bestätigen, bevor sie fortgesetzt wird.
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.
Der Bereitstellungsmodus.
Bereitstellungsname
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“.
Nicht auf den Abschluss lang andauernder Vorgänge warten
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. Beachten Sie auch, wenn Sie eine bicepparam-Datei angeben, können Sie dieses Argument nur einmal verwenden.
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.
Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.
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.
Der Pfad zur Vorlagendatei oder Bicep-Datei.
Die Ressourcen-ID der Vorlage.
Der URI der Vorlagendatei.
Weisen Sie den Befehl an, was-wäre-wenn für die Bereitstellung auszuführen.
Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von Den-Wäre-Ergebnissen ausgeschlossen werden sollen. Anwendbar, wenn --confirm-with-what-if festgelegt ist.
Das Format der Was-Wäre-Ergebnisse. Gilt, wenn --confirm-with-what-if
festgelegt wird.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group delete
Löschen sie eine Bereitstellung in der Ressourcengruppe.
az deployment group delete --name
--resource-group
[--no-wait]
Beispiele
Löschen sie eine Bereitstellung in der Ressourcengruppe.
az deployment group delete -g testrg -n deployment01
Erforderliche Parameter
Bereitstellungsname
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Nicht auf den Abschluss lang andauernder Vorgänge warten
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group export
Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird.
az deployment group export --name
--resource-group
Beispiele
Exportieren Sie die Vorlage, die für eine Bereitstellung in der Ressourcengruppe verwendet wird.
az deployment group export --resource-group testrg --name MyDeployment
Erforderliche Parameter
Bereitstellungsname
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group list
Auflisten von Bereitstellungen in der Ressourcengruppe.
az deployment group list --resource-group
[--filter]
Beispiele
Auflisten von Bereitstellungen in der Ressourcengruppe.
az deployment group list -g testrg
Erforderliche Parameter
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Filterausdruck mit OData-Notation. Sie können "provisioningState eq '{state}'" verwenden, um provisioningState zu filtern. Um weitere Informationen zu erhalten, besuchen https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parametersSie bitte .
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group show
Anzeigen einer Bereitstellung in der Ressourcengruppe.
az deployment group show --name
--resource-group
Beispiele
Anzeigen einer Bereitstellung in der Ressourcengruppe.
az deployment group show -g testrg -n deployment01
Erforderliche Parameter
Bereitstellungsname
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group validate
Überprüfen Sie, ob eine Vorlage in der Ressourcengruppe gültig ist.
Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.
az deployment group validate --resource-group
[--handle-extended-json-format]
[--mode {Complete, Incremental}]
[--name]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--rollback-on-error]
[--template-file]
[--template-spec]
[--template-uri]
Beispiele
Überprüfen Sie, ob eine Vorlage in der Ressourcengruppe gültig ist.
az deployment group validate --resource-group testrg --template-file {template-file}
Überprüfen Sie, ob eine Vorlage in der Ressourcengruppe gültig ist. (automatisch generiert)
az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json
Erforderliche Parameter
Die Ressourcengruppe, unter der die Bereitstellung erstellt werden soll.
Optionale Parameter
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.
Der Bereitstellungsmodus.
Bereitstellungsname
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“.
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.
Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.
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.
Der Pfad zur Vorlagendatei oder Bicep-Datei.
Die Ressourcen-ID der Vorlage.
Der URI der Vorlagendatei.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group wait
Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist.
az deployment group 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 deployment group wait --created --name MyDeployment --resource-group MyResourceGroup
Erforderliche Parameter
Bereitstellungsname
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Abrufintervall in Sekunden.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az deployment group what-if
Führen Sie einen Bereitstellungs-What-If-Vorgang im Ressourcengruppenbereich aus.
Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.
az deployment group what-if --resource-group
[--aux-tenants]
[--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--mode {Complete, Incremental}]
[--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 Bereitstellungs-What-If-Vorgang in einer Ressourcengruppe aus.
az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Führen Sie einen Bereitstellungs-What-If-Vorgang in einer Ressourcengruppe mit dem ResourceIdOnly-Format aus.
az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly
Führen Sie einen Was-Wenn-Bereitstellungsvorgang in einer Ressourcengruppe aus, ohne das Ergebnis ziemlich zu drucken.
az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print
Erforderliche Parameter
Die Ressourcengruppe zum Ausführen des Bereitstellungs-What-If-Vorgangs unter.
Optionale Parameter
Hilfsmandanten, die während der Bereitstellung über Mandanten hinweg verwendet werden.
Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von Den-Wäre-Ergebnissen ausgeschlossen werden sollen.
Der Bereitstellungsmodus.
Bereitstellungsname
Deaktivieren Sie "Hübsches Drucken" für Was-Wäre-Ergebnisse. Bei Festlegung wird der Ausgabeformattyp verwendet.
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“.
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.
Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.
Das Format der Was-Wäre-Ergebnisse.
Der Pfad zur Vorlagendatei oder Bicep-Datei.
Die Ressourcen-ID der Vorlage.
Der URI der Vorlagendatei.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.