Feedback

az deployment group

  • Referenz

Verwalten der Azure Resource Manager Vorlagenbereitstellung in Ressourcengruppe.

Befehle

az deployment group cancel

Abbrechen einer Bereitstellung in der Ressourcengruppe.
az deployment group create

Starten Sie eine Bereitstellung in der Ressourcengruppe.
az deployment group delete

Löschen einer Bereitstellung in der Ressourcengruppe.
az deployment group export

Exportiert die für die Bereitstellung verwendete Vorlage.
az deployment group list

Listet Bereitstellungen in der Ressourcengruppe auf.
az deployment group show

Zeigen Sie eine Bereitstellung in der Ressourcengruppe an.
az deployment group validate

Überprüfen Sie, ob eine Vorlage in der Ressourcengruppe gültig ist.
az deployment group wait

Platzieren Sie die CLI in einem Wartezeitzustand, bis eine Bereitstellungsbedingung erfüllt ist.
az deployment group what-if

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

az deployment group cancel

Bearbeiten

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

--name -n

Bereitstellungsname

--resource-group -g

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

az deployment group create

Bearbeiten

Starten Sie eine Bereitstellung in der Ressourcengruppe.

Geben Sie nur eine dateidatei | an.-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 mit 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 selektiven Außerkraftsetzung von Schlüssel-/Wertpaaren.

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

Erforderliche Parameter

--resource-group -g

Die Ressourcengruppe zum Erstellen der Bereitstellung bei.

Optionale Parameter

--aux-subs

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

--aux-tenants

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

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

Unterstützung für die Behandlung erweiterter Vorlageninhalte einschließlich multiliner und Kommentaren in der Bereitstellung.

--mode

Der Bereitstellungsmodus.

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

Bereitstellungsname

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für DIE ARM-Vorlage. Wenn der Wert wahr ist, wird die Aufforderung, dass Benutzer fehlenden Parameter bereitstellen müssen, ignoriert. Der Standardwert ist „FALSE“.

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

Nicht auf den Abschluss lang andauernder Vorgänge warten

--parameters -p

Bereitstellen von Parameterwerten.

--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), das bei verknüpften Vorlagen verwendet werden soll.

--rollback-on-error

Der Name einer Bereitstellung, die auf Fehler zurückgespielt werden soll, oder verwenden Sie als Flag zum Zurücksetzen auf die letzte erfolgreiche Bereitstellung.

--template-file -f

Der Pfad zur Vorlagendatei oder Bicep-Datei.

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Der URI für die Vorlagendatei.

--what-if -w

Weisen Sie den Befehl an, Bereitstellungs-Was-If auszuführen.

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

Leergetrennte 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 von What-If Ergebnissen. Anwendbar, wenn --confirm-with-what-if festgelegt ist.

Zulässige Werte: FullResourcePayloads, ResourceIdOnly
Standardwert: FullResourcePayloads

az deployment group delete

Bearbeiten

Löschen einer Bereitstellung in der Ressourcengruppe.

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

Beispiele

Löschen einer Bereitstellung in der Ressourcengruppe.

az deployment group delete -g testrg -n deployment01

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

az deployment group export

Bearbeiten

Exportiert die für die Bereitstellung verwendete Vorlage.

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

--name -n

Bereitstellungsname

--resource-group -g

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

az deployment group list

Bearbeiten

Listet Bereitstellungen in der Ressourcengruppe auf.

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

Beispiele

Listet Bereitstellungen in der Ressourcengruppe auf.

az deployment group list -g testrg

Erforderliche Parameter

--resource-group -g

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

Optionale Parameter

--filter

Filterausdruck mit OData-Notation. Sie können "provisioningState eq '{state}'" verwenden, um bereitstellungState zu filtern. Um weitere Informationen zu erhalten, besuchen https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parametersSie bitte .

az deployment group show

Bearbeiten

Zeigen Sie eine Bereitstellung in der Ressourcengruppe an.

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

Beispiele

Zeigen Sie eine Bereitstellung in der Ressourcengruppe an.

az deployment group show -g testrg -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

--resource-group -g

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

az deployment group validate

Bearbeiten

Überprüfen Sie, ob eine Vorlage in der Ressourcengruppe gültig ist.

Geben Sie nur eine dateidatei | an.-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

--resource-group -g

Die Ressourcengruppe zum Erstellen der Bereitstellung bei.

Optionale Parameter

--handle-extended-json-format -j

Unterstützung für die Behandlung erweiterter Vorlageninhalte einschließlich multiliner und Kommentaren in der Bereitstellung.

--mode

Der Bereitstellungsmodus.

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

Bereitstellungsname

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für DIE ARM-Vorlage. Wenn der Wert wahr ist, wird die Aufforderung, dass Benutzer fehlenden Parameter bereitstellen müssen, ignoriert. Der Standardwert ist „FALSE“.

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

Bereitstellen von Parameterwerten.

--query-string -q

Die Abfragezeichenfolge (ein SAS-Token), das bei verknüpften Vorlagen verwendet werden soll.

--rollback-on-error

Der Name einer Bereitstellung, die auf Fehler zurückgespielt werden soll, oder verwenden Sie als Flag zum Zurücksetzen auf die letzte erfolgreiche Bereitstellung.

--template-file -f

Der Pfad zur Vorlagendatei oder Bicep-Datei.

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Der URI für die Vorlagendatei.

az deployment group wait

Bearbeiten

Platzieren Sie die CLI in einem Wartezeitzustand, 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 Wartezeitzustand, bis eine Bereitstellungsbedingung erfüllt ist. (automatisch generiert)

az deployment group 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 "Erfolgreich" erstellt wurden.

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

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter "Erfolgreich" aktualisiert wurde.

az deployment group what-if

Bearbeiten

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

Geben Sie nur eine dateidatei | an.-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 eine Bereitstellung What-If Vorgangs 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 Bereitstellungsvorgang What-If bei 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

--resource-group -g

Die Ressourcengruppe, um die Bereitstellung What-If Vorgang auszuführen.

Optionale Parameter

--aux-tenants

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

--exclude-change-types -x

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

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

Der Bereitstellungsmodus.

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

Bereitstellungsname

--no-pretty-print

Deaktivieren Sie den ziemlichen Druck für What-If Ergebnisse. Beim Festlegen wird der Ausgabeformattyp verwendet.

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für DIE ARM-Vorlage. Wenn der Wert wahr ist, wird die Aufforderung, dass Benutzer fehlenden Parameter bereitstellen müssen, ignoriert. Der Standardwert ist „FALSE“.

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

Bereitstellen von Parameterwerten.

--query-string -q

Die Abfragezeichenfolge (ein SAS-Token), das bei verknüpften Vorlagen verwendet werden soll.

--result-format -r

Das Format von What-If Ergebnissen.

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 für die Vorlagendatei.