Freigeben über


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.

Core GA
az deployment mg create

Starten Sie eine Bereitstellung in der Verwaltungsgruppe.

Core GA
az deployment mg delete

Löschen sie eine Bereitstellung in der Verwaltungsgruppe.

Core GA
az deployment mg export

Exportieren Sie die Vorlage, die für eine Bereitstellung verwendet wird.

Core GA
az deployment mg list

Auflisten von Bereitstellungen in der Verwaltungsgruppe.

Core GA
az deployment mg show

Anzeigen einer Bereitstellung in der Verwaltungsgruppe.

Core GA
az deployment mg validate

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

Core GA
az deployment mg wait

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

Core GA
az deployment mg what-if

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

Core 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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Der Bereitstellungsname.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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]
                        [--validation-level {Provider, ProviderNoRbac, Template}]
                        [--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

--___location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

--management-group-id -m

Die Verwaltungsgruppen-ID zum Erstellen der Bereitstellung unter.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Als veraltet markiert

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.

--mode

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.

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

Der Bereitstellungsname.

--no-prompt

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

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--parameters -p

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.

--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), die bei verknüpften Vorlagen mit dem Vorlagen-URI 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 der Vorlagendatei.

--validation-level

Die Bereitstellungsüberprüfungsstufe. Kann auf "Provider" (Standard), "Template" oder "ProviderNoRbac" festgelegt werden. Mit einer Überprüfungsstufe von "Provider" führt ARM die vollständige Überprüfung durch und überprüft, ob Sie über ausreichende Berechtigungen zum Bereitstellen aller Ressourcen in der Vorlage verfügen. Mit einer Überprüfungsstufe von "providerNoRbac" führt ARM eine vollständige Überprüfung durch, überprüft jedoch nur auf Leseberechtigungen für jede Ressource. Bei einer Gültigkeitsprüfungsstufe von "Vorlage" wird nur eine statische Überprüfung durchgeführt: Vorab- und Berechtigungsprüfungen werden übersprungen.

Eigenschaft Wert
Zulässige Werte: Provider, ProviderNoRbac, Template
--what-if -w

Weisen Sie den Befehl an, was-wäre-wenn für die Bereitstellung auszuführen.

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

Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von What-If Ergebnissen ausgeschlossen werden sollen. Anwendbar, wenn --confirm-with-what-if festgelegt ist.

Eigenschaft Wert
Zulässige Werte: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Das Format der What-If Ergebnisse. Gilt, wenn --confirm-with-what-if festgelegt ist.

Eigenschaft Wert
Standardwert: FullResourcePayloads
Zulässige Werte: FullResourcePayloads, ResourceIdOnly
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Der Bereitstellungsname.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Der Bereitstellungsname.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter
Vorschau

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

--management-group-id -m

Die Verwaltungsgruppen-ID.

--name -n

Der Bereitstellungsname.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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]
                          [--validation-level {Provider, ProviderNoRbac, Template}]

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. (autogenerated)

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 zum Erstellen der Bereitstellung unter.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--handle-extended-json-format -j
Als veraltet markiert

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.

--name -n

Der Bereitstellungsname.

--no-prompt

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

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--parameters -p

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.

--query-string -q

Die Abfragezeichenfolge (ein SAS-Token), die bei verknüpften Vorlagen mit dem Vorlagen-URI 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 der Vorlagendatei.

--validation-level

Die Bereitstellungsüberprüfungsstufe. Kann auf "Provider" (Standard), "Template" oder "ProviderNoRbac" festgelegt werden. Mit einer Überprüfungsstufe von "Provider" führt ARM die vollständige Überprüfung durch und überprüft, ob Sie über ausreichende Berechtigungen zum Bereitstellen aller Ressourcen in der Vorlage verfügen. Mit einer Überprüfungsstufe von "providerNoRbac" führt ARM eine vollständige Überprüfung durch, überprüft jedoch nur auf Leseberechtigungen für jede Ressource. Bei einer Gültigkeitsprüfungsstufe von "Vorlage" wird nur eine statische Überprüfung durchgeführt: Vorab- und Berechtigungsprüfungen werden übersprungen.

Eigenschaft Wert
Zulässige Werte: Provider, ProviderNoRbac, Template
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

Der Bereitstellungsname.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Eigenschaft Wert
Parameter group: Wait Condition Arguments
--deleted

Warten Sie, bis sie gelöscht wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--interval

Abrufintervall in Sekunden.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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]
                         [--validation-level {Provider, ProviderNoRbac, Template}]

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

--___location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

--management-group-id -m

Die Verwaltungsgruppen-ID zum Erstellen der Bereitstellung unter.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--exclude-change-types -x

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

Eigenschaft Wert
Zulässige Werte: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Der Bereitstellungsname.

--no-pretty-print

Deaktivieren Sie "Pretty Print" für What-If Ergebnisse. Bei Festlegung wird der Ausgabeformattyp verwendet.

--no-prompt

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

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--parameters -p

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.

--query-string -q

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

--result-format -r

Das Format der What-If Ergebnisse.

Eigenschaft Wert
Standardwert: FullResourcePayloads
Zulässige Werte: FullResourcePayloads, ResourceIdOnly
--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.

--validation-level

Die Bereitstellungsüberprüfungsstufe. Kann auf "Provider" (Standard), "Template" oder "ProviderNoRbac" festgelegt werden. Mit einer Überprüfungsstufe von "Provider" führt ARM die vollständige Überprüfung durch und überprüft, ob Sie über ausreichende Berechtigungen zum Bereitstellen aller Ressourcen in der Vorlage verfügen. Mit einer Überprüfungsstufe von "providerNoRbac" führt ARM eine vollständige Überprüfung durch, überprüft jedoch nur auf Leseberechtigungen für jede Ressource. Bei einer Gültigkeitsprüfungsstufe von "Vorlage" wird nur eine statische Überprüfung durchgeführt: Vorab- und Berechtigungsprüfungen werden übersprungen.

Eigenschaft Wert
Zulässige Werte: Provider, ProviderNoRbac, Template
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False