az deployment mg
Verwalten sie die Azure Resource Manager-Vorlagenbereitstellung in der Verwaltungsgruppe.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az deployment mg cancel |
Abbrechen einer Bereitstellung in der Verwaltungsgruppe. |
Kern | GA |
az deployment mg create |
Starten Sie eine Bereitstellung in der Verwaltungsgruppe. |
Kern | GA |
az deployment mg delete |
Löschen sie eine Bereitstellung in der Verwaltungsgruppe. |
Kern | GA |
az deployment mg export |
Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird. |
Kern | GA |
az deployment mg list |
Auflisten von Bereitstellungen in der Verwaltungsgruppe. |
Kern | GA |
az deployment mg show |
Anzeigen einer Bereitstellung in der Verwaltungsgruppe. |
Kern | GA |
az deployment mg validate |
Überprüfen Sie, ob eine Vorlage in der Verwaltungsgruppe gültig ist. |
Kern | GA |
az deployment mg wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist. |
Kern | GA |
az deployment mg what-if |
Führen Sie eine Bereitstellung What-If Vorgang im Verwaltungsgruppenbereich aus. |
Kern | GA |
az deployment mg cancel
Abbrechen einer Bereitstellung in der Verwaltungsgruppe.
az deployment mg cancel --management-group-id
--name
Beispiele
Abbrechen einer Bereitstellung in der Verwaltungsgruppe.
az deployment mg cancel -m testmg -n deployment01
Erforderliche Parameter
Die Verwaltungsgruppen-ID.
Der Bereitstellungsname.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg create
Starten Sie eine Bereitstellung in der Verwaltungsgruppe.
Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.
az deployment mg create --location
--management-group-id
[--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]
[--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 Verwaltungsgruppe aus einer Remotevorlagendatei mithilfe von Parametern aus einer lokalen JSON-Datei.
az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
--template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Erstellen Sie eine Bereitstellung in der Verwaltungsgruppe aus einer lokalen Vorlagendatei mithilfe von Parametern aus einer JSON-Zeichenfolge.
az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
--template-file azuredeploy.json \
--parameters '{ \"policyName\": { \"value\": \"policy2\" } }'
Erstellen Sie eine Bereitstellung in der Verwaltungsgruppe aus einer lokalen Vorlage, mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiver Außerkraftsetzung von Schlüssel-Wert-Paaren.
az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
--template-file azuredeploy.json --parameters @params.json \
--parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json
Erforderliche Parameter
Der Speicherort zum Speichern der Bereitstellungsmetadaten.
Die Verwaltungsgruppen-ID zum Erstellen der Bereitstellung unter.
Optionale Parameter
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.
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 Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder inkrementell oder abgeschlossen sein. Im inkrementellen Modus werden Ressourcen bereitgestellt, ohne vorhandene Ressourcen zu löschen, die nicht in der Vorlage enthalten sind. Im Vollständigen Modus werden Ressourcen bereitgestellt und vorhandene Ressourcen in der Ressourcengruppe, die nicht in der Vorlage enthalten sind, gelöscht. Achten Sie darauf, wenn Sie den Vollständigen Modus verwenden, da Sie möglicherweise unbeabsichtigt Ressourcen löschen.
Der 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".
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
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.
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 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 What-If Ergebnissen ausgeschlossen werden sollen. Anwendbar, wenn --confirm-with-what-if festgelegt ist.
Das Format der What-If Ergebnisse. Gilt, wenn --confirm-with-what-if
festgelegt ist.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg delete
Löschen sie eine Bereitstellung in der Verwaltungsgruppe.
az deployment mg delete --management-group-id
--name
[--no-wait]
Beispiele
Löschen sie eine Bereitstellung in der Verwaltungsgruppe.
az deployment mg delete -m testmg -n deployment01
Erforderliche Parameter
Die Verwaltungsgruppen-ID.
Der Bereitstellungsname.
Optionale Parameter
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg export
Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird.
az deployment mg export --management-group-id
--name
Beispiele
Exportieren Sie die Vorlage, die für eine Bereitstellung in der Verwaltungsgruppe verwendet wird.
az deployment mg export --management-group-id testmg --name MyDeployment
Erforderliche Parameter
Die Verwaltungsgruppen-ID.
Der Bereitstellungsname.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg list
Auflisten von Bereitstellungen in der Verwaltungsgruppe.
az deployment mg list --management-group-id
[--filter]
Beispiele
Auflisten von Bereitstellungen in der Verwaltungsgruppe.
az deployment mg list -m testmg
Erforderliche Parameter
Die Verwaltungsgruppen-ID.
Optionale Parameter
Filterausdruck mit OData-Notation. Sie können "provisioningState eq '{state}'" verwenden, um provisioningState zu filtern. Weitere Informationen erhalten Sie unter https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg show
Anzeigen einer Bereitstellung in der Verwaltungsgruppe.
az deployment mg show --management-group-id
--name
Beispiele
Anzeigen einer Bereitstellung in der Verwaltungsgruppe.
az deployment mg show -m testmg -n deployment01
Erforderliche Parameter
Die Verwaltungsgruppen-ID.
Der Bereitstellungsname.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg validate
Überprüfen Sie, ob eine Vorlage in der Verwaltungsgruppe gültig ist.
Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.
az deployment mg validate --location
--management-group-id
[--handle-extended-json-format]
[--name]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
Beispiele
Überprüfen Sie, ob eine Vorlage in der Verwaltungsgruppe gültig ist.
az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}
Überprüfen Sie, ob eine Vorlage in der Verwaltungsgruppe gültig ist. (automatisch generiert)
az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json
Erforderliche Parameter
Der Speicherort zum Speichern der Bereitstellungsmetadaten.
Die Verwaltungsgruppen-ID zum Erstellen der Bereitstellung unter.
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 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=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.
Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.
Der Pfad zur Vorlagendatei oder Bicep-Datei.
Die Ressourcen-ID der Vorlage.
Der URI der Vorlagendatei.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg wait
Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist.
az deployment mg wait --management-group-id
--name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Erforderliche Parameter
Die Verwaltungsgruppen-ID.
Der Bereitstellungsname.
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
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
az deployment mg what-if
Führen Sie eine Bereitstellung What-If Vorgang im Verwaltungsgruppenbereich aus.
Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.
az deployment mg what-if --location
--management-group-id
[--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--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 Vorgang in einer Verwaltungsgruppe aus.
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Führen Sie eine Bereitstellung What-If Vorgangs in einer Verwaltungsgruppe mit dem ResourceIdOnly-Format aus.
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly
Führen Sie eine Bereitstellung What-If Vorgang in einer Verwaltungsgruppe aus, ohne das Ergebnis ziemlich zu drucken.
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print
Erforderliche Parameter
Der Speicherort zum Speichern der Bereitstellungsmetadaten.
Die Verwaltungsgruppen-ID zum Erstellen der Bereitstellung unter.
Optionale Parameter
Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von What-If Ergebnissen ausgeschlossen werden sollen.
Der Bereitstellungsname.
Deaktivieren Sie "Pretty Print" für What-If 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=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.
Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI verwendet werden soll.
Das Format der What-If Ergebnisse.
Der Pfad zur Vorlagendatei oder Bicep-Datei.
Die Ressourcen-ID der Vorlage.
Der URI der Vorlagendatei.
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
Diese Hilfenachricht anzeigen und beenden.
Nur Fehler anzeigen, Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_ID
konfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.