Feedback

az group deployment

  • Referenz

Verwalten von Azure Resource Manager Bereitstellungen.

Befehle

az group deployment cancel

Bricht eine derzeit ausgeführte Vorlagenbereitstellung ab.
az group deployment create

Startet eine Bereitstellung.
az group deployment delete

Löscht eine Bereitstellung aus dem Bereitstellungsverlauf.
az group deployment export

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

Listet alle Bereitstellungen einer Ressourcengruppe auf.
az group deployment operation

Verwalten von Bereitstellungsvorgängen.
az group deployment operation list

Ruft alle Bereitstellungsvorgänge für eine Bereitstellung ab.
az group deployment operation show

Rufen Sie den Vorgang einer Bereitstellung ab.
az group deployment show

Ruft eine Bereitstellung ab.
az group deployment validate

Überprüfen Sie, ob eine Vorlage syntaktisch korrekt ist.
az group deployment wait

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

az group deployment cancel

Bearbeiten

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 aktuell ausgeführte Vorlagenbereitstellung beendet. Die Ressourcengruppe bleibt 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.

az group deployment create

Bearbeiten

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 mit einer lokalen Parameterdatei, einer Remoteparameterdatei und selektiven Außerkraftsetzung 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

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

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 Abschließen (entfernen Sie zusätzliche Ressourcen aus der Ressourcengruppe).

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

Bereitstellungsname Standardmäßiger Dateibasisname der Vorlage.

--no-prompt

Die Option zum Deaktivieren der Eingabeaufforderung fehlender Parameter für ARM-Vorlage. Wenn der Wert wahr ist, wird die Aufforderung, dass Benutzer fehlenden Parameter bereitstellen, 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.

--rollback-on-error

Der Name einer Bereitstellung, die auf Fehler zurückgesetzt werden soll, oder verwenden Sie als Flag, um zurück zur letzten erfolgreichen Bereitstellung zurückzukehren.

--template-file -f

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

--template-uri -u

Ein URI für eine Remotevorlagendatei.

az group deployment delete

Bearbeiten

Löscht eine Bereitstellung aus dem Bereitstellungsverlauf.

Eine Vorlagenbereitstellung, die aktuell ausgeführt wird, kann nicht gelöscht werden. Durch das Löschen einer Vorlagenbereitstellung werden die zugehörigen Bereitstellungsvorgänge ebenfalls entfernt. Das Löschen einer Vorlagenbereitstellung wirkt sich nicht auf den Zustand der Ressourcengruppe aus. Dies ist ein asynchroner Vorgang, der einen Status von 202 zurückgibt, bis die Vorlagenbereitstellung erfolgreich gelöscht wird. Der Location-Antwortheader enthält den URI, der zum Abrufen des Status des Prozesses verwendet wird. Während der Prozess ausgeführt wird, gibt ein Aufruf des URIs im Speicherortheader den Status 202 zurück. Wenn der Prozess abgeschlossen ist, gibt der URI im Speicherortheader einen Status von 204 für den 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

az group deployment export

Bearbeiten

Exportiert die für die Bereitstellung verwendete Vorlage.

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

Beispiele

Exportiert die für die Bereitstellung verwendete Vorlage. (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.

az group deployment list

Bearbeiten

Listet alle Bereitstellungen einer Ressourcengruppe auf.

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 beispielsweise $filter=provisioningState eq '{state}' verwenden. Der Standardwert ist Keine.

--top

Die Anzahl der Ergebnisse, die abgerufen werden sollen. Wenn Null übergeben wird, werden alle Bereitstellungen zurückgegeben. Der Standardwert ist Keine.

az group deployment show

Bearbeiten

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.

az group deployment validate

Bearbeiten

Überprüfen Sie, ob eine Vorlage syntactisch 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 syntactisch 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

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

--mode

Inkrementell (nur Ressourcen zu Ressourcengruppe hinzufügen) oder Vollständig (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 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.

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

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

--template-uri -u

Ein URI für eine Remotevorlagendatei.

az group deployment wait

Bearbeiten

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

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

Platzieren Sie die CLI in einem Wartezeitzustand, 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 "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.