az deployment mg

Verwalten der Azure Resource Manager Vorlagenbereitstellung in der Verwaltungsgruppe.

Befehle

az deployment mg cancel

Abbrechen einer Bereitstellung in der Verwaltungsgruppe.

az deployment mg create

Starten Sie eine Bereitstellung in der Verwaltungsgruppe.

az deployment mg delete

Löschen einer Bereitstellung in der Verwaltungsgruppe.

az deployment mg export

Exportiert die für die Bereitstellung verwendete Vorlage.

az deployment mg list

Listet Bereitstellungen in der Verwaltungsgruppe auf.

az deployment mg show

Zeigen Sie eine Bereitstellung in der Verwaltungsgruppe an.

az deployment mg validate

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

az deployment mg wait

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

az deployment mg what-if

Führen Sie eine Bereitstellung What-If Operation im Verwaltungsgruppenbereich aus.

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Bereitstellungsname

az deployment mg create

Starten Sie eine Bereitstellung in der Verwaltungsgruppe.

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

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

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

--management-group-id -m

Die Verwaltungsgruppen-ID, um die Bereitstellung zu erstellen.

Optionale Parameter

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

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

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

Löschen einer Bereitstellung in der Verwaltungsgruppe.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

Beispiele

Löschen einer Bereitstellung in der Verwaltungsgruppe.

az deployment mg delete -m testmg -n deployment01

Erforderliche Parameter

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Bereitstellungsname

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

az deployment mg export

Exportiert die für die Bereitstellung verwendete Vorlage.

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Bereitstellungsname

az deployment mg list

Listet Bereitstellungen in der Verwaltungsgruppe auf.

az deployment mg list --management-group-id
                      [--filter]

Beispiele

Listet Bereitstellungen in der Verwaltungsgruppe auf.

az deployment mg list -m testmg

Erforderliche Parameter

--management-group-id -m

Die Verwaltungsgruppen-ID.

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

Zeigen Sie eine Bereitstellung in der Verwaltungsgruppe an.

az deployment mg show --management-group-id
                      --name

Beispiele

Zeigen Sie eine Bereitstellung in der Verwaltungsgruppe an.

az deployment mg show -m testmg -n deployment01

Erforderliche Parameter

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Bereitstellungsname

az deployment mg validate

Überprüfen Sie, ob eine Vorlage bei der Verwaltungsgruppe gültig ist.

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

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

--management-group-id -m

Die Verwaltungsgruppen-ID, um die Bereitstellung zu erstellen.

Optionale Parameter

--handle-extended-json-format -j

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

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

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Bereitstellungsname

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 die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.

az deployment mg what-if

Führen Sie eine Bereitstellung What-If Vorgang im Bereich der Verwaltungsgruppe aus.

Geben Sie nur eine datei-datei-| an.-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 Vorgangs 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 Operation 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 Operation 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

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

--management-group-id -m

Die Verwaltungsgruppen-ID zum Erstellen der Bereitstellung bei.

Optionale Parameter

--exclude-change-types -x

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

Zulässige Werte: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--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 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
--parameters -p

Bereitstellen von Parameterwerten.

--query-string -q

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

--result-format -r

Das Format What-If Ergebnisse.

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