az stack-whatif sub
Verwalten von Bereitstellungsstapeln was-wäre-wenn-Ergebnisse im Abonnementbereich.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az stack-whatif sub create |
Erstellen Sie einen Bereitstellungsstapel, was-wäre-wenn-Ergebnis im Abonnementbereich. |
Core | GA |
| az stack-whatif sub delete |
Löschen Sie einen Bereitstellungsstapel, was-wäre-wenn-Ergebnis aus dem Abonnementbereich. |
Core | GA |
| az stack-whatif sub list |
Listet alle Bereitstellungsstapel-Was-wäre-wenn-Ergebnisse in einem Abonnement auf. |
Core | GA |
| az stack-whatif sub show |
Rufen Sie einen Bereitstellungsstapel ab, was-wäre-wenn-Ergebnis aus dem Abonnementbereich. |
Core | GA |
az stack-whatif sub create
Erstellen Sie einen Bereitstellungsstapel, was-wäre-wenn-Ergebnis im Abonnementbereich.
az stack-whatif sub create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
--deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
--location
--name
--retention-interval --ri
--stack-id
[--acquire-policy-token]
[--change-reference]
[--cs --deny-settings-apply-to-child-scopes]
[--deny-settings-excluded-actions --ea]
[--deny-settings-excluded-principals --ep]
[--deployment-resource-group --dr]
[--description]
[--no-color]
[--no-pretty-print]
[--no-wait]
[--parameters]
[--query-string]
[--resources-without-delete-support --rwd {detach, fail}]
[--tags]
[--template-file]
[--template-spec]
[--template-uri]
[--validation-level --vl {Provider, ProviderNoRbac, Template}]
Beispiele
Führen Sie einen Was-wäre-wenn-Vorgang auf einem Bereitstellungsstapel mithilfe der Vorlagendatei aus, und trennen Sie alle Ressourcen für die Nichtmanage.
az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wäre-wenn-Vorgang in einem Bereitstellungsstapel mit Parameterdatei aus, löschen Sie Ressourcen für nicht verwaltete Ressourcen, und entfernen Sie Die Farbe aus der Ausgabe.
az stack-whatif sub create --name StackName --action-on-unmanage deleteResources --no-color --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wenn-Vorgang auf einem Bereitstellungsstapel mit Vorlagenspezifikation aus.
az stack-whatif sub create --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wenn-Vorgang in einem Bereitstellungsstapel mithilfe der Bicep-Datei aus, und löschen Sie alle Ressourcen für die nicht verwaltete Datei.
az stack-whatif sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wenn-Vorgang in einem Bereitstellungsstapel in einem anderen Abonnement aus.
az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wenn-Vorgang in einem Bereitstellungsstapel aus, und stellen Sie sie im Bereich der Ressourcengruppe bereit.
az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wenn-Vorgang in einem Bereitstellungsstapel mithilfe von Parametern aus Schlüssel-Wert-Paaren aus.
az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie einen Was-wäre-wenn-Vorgang in einem Bereitstellungsstapel aus einer lokalen Vorlage mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiven Außerkraftsetzung von Schlüssel-Wert-Paaren aus.
az stack-whatif sub create --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie eine Was-wäre-wenn-Aktion auf einem Bereitstellungsstapel aus einer lokalen Vorlage mithilfe von Verweigerungseinstellungen aus.
az stack-whatif sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Führen Sie eine Was-wäre-wenn-Aktion auf einem Bereitstellungsstapel aus einer lokalen Vorlage aus, und wenden Sie die Einstellungen für Verweigerungen auf untergeordnete Bereiche an.
az stack-whatif sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack
Erforderliche Parameter
Definiert, was mit Ressourcen geschieht, die nicht mehr verwaltet werden, nachdem der Stapel aktualisiert oder gelöscht wurde.
| Eigenschaft | Wert |
|---|---|
| Zulässige Werte: | deleteAll, deleteResources, detachAll |
Definieren Sie, welche Vorgänge für vom Stapel verwaltete Ressourcen verweigert werden.
| Eigenschaft | Wert |
|---|---|
| Zulässige Werte: | denyDelete, denyWriteAndDelete, none |
Der Speicherort zum Speichern des Bereitstellungsstapels ( Was-wäre-wenn-Ergebnis).
Der Name des Bereitstellungsstapels was-wäre-wenn-Ergebnis.
Das Aufbewahrungsintervall für What-If Ergebnisse. Der Wert muss im ISO 8601-Format und zwischen 1 Tag und 30 Tagen vorliegen.
Die vollqualifizierte ID des Bereitstellungsstapels, um einen Was-wäre-wenn-Vorgang auszuführen.
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Global Policy Arguments |
Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Global Policy Arguments |
"DenySettings" wird auf untergeordnete Bereiche angewendet.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Liste der rollenbasierten Verwaltungsvorgänge, die von den denySettings ausgeschlossen sind. Bis zu 200 Aktionen sind zulässig.
Liste der von der Sperre ausgeschlossenen AAD-Prinzipal-IDs. Bis zu 5 Prinzipale sind zulässig.
Der Bereich, in dem die anfängliche Bereitstellung erstellt werden soll. Wenn kein Bereich angegeben ist, wird er standardmäßig auf den Bereich des Bereitstellungsstapels festgelegt.
Die Beschreibung des Bereitstellungsstapels.
Deaktivieren Sie die Farbe in ziemlich gedruckten Was-wäre-wenn-Ergebnissen.
Deaktivieren Sie "Pretty Print" für What-If Ergebnisse. Bei Festlegung wird der Ausgabeformattyp verwendet.
Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
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.
Definiert, was mit Ressourcen geschieht, die das Löschen nicht unterstützen, wenn sie nicht mehr vom Stapel verwaltet werden.
| Eigenschaft | Wert |
|---|---|
| Zulässige Werte: | detach, fail |
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Ein Pfad zu einer Vorlagendatei oder Bicep Datei im Dateisystem.
Die Ressourcen-ID der Vorlage.
Ein URI für eine Remotevorlagendatei.
Überprüfungsebene für den Bereitstellungsstapel. Der Standardwert ist "Provider".
| Eigenschaft | Wert |
|---|---|
| Zulässige Werte: | Provider, ProviderNoRbac, Template |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
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_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az stack-whatif sub delete
Löschen Sie einen Bereitstellungsstapel, was-wäre-wenn-Ergebnis aus dem Abonnementbereich.
az stack-whatif sub delete [--acquire-policy-token]
[--change-reference]
[--id]
[--name]
[--yes]
Beispiele
Löschen Sie ein Stapel-Was-wäre-wenn-Ergebnis anhand des Namens.
az stack-whatif sub delete --name StackName
Löschen Eines Stapel-Was-wäre-wenn-Ergebnisses nach Ressourcen-ID.
az stack-whatif sub delete --id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacksWhatIfResults/ResultName
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Global Policy Arguments |
Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.
| Eigenschaft | Wert |
|---|---|
| Parametergruppe: | Global Policy Arguments |
Der Bereitstellungsstapel was-wäre-wenn-Ergebnisressourcen-ID.
Der Name des Bereitstellungsstapels was-wäre-wenn-Ergebnis.
Nicht um Bestätigung bitten.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
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_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az stack-whatif sub list
Listet alle Bereitstellungsstapel-Was-wäre-wenn-Ergebnisse in einem Abonnement auf.
az stack-whatif sub list
Beispiele
Listet alle Stapel-Was-wäre-wenn-Ergebnisse des aktuellen Abonnements auf.
az stack-whatif sub list
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
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_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
az stack-whatif sub show
Rufen Sie einen Bereitstellungsstapel ab, was-wäre-wenn-Ergebnis aus dem Abonnementbereich.
az stack-whatif sub show [--id]
[--name]
[--no-color]
[--no-pretty-print]
[--with-property-changes --wpc {false, true}]
Beispiele
Dient zum Abrufen eines Stapel-Was-wäre-wenn-Ergebnisses anhand des Namens.
az stack-whatif sub show --name ResultName
Dient zum Abrufen eines Stapel-Was-wäre-wenn-Ergebnisses nach Name ohne Farbe.
az stack-whatif sub show --name ResultName --no-color
Rufen Sie JSON für ein Stapel-Was-wäre-wenn-Ergebnis anhand des Namens ab.
az stack-whatif sub show --name ResultName --no-pretty-print
Rufen Sie ein Stapel-Was-wäre-wenn-Ergebnis nach Ressourcen-ID ab.
az stack-whatif sub show --id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacksWhatIfResults/ResultName
Optionale Parameter
Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.
Der Bereitstellungsstapel was-wäre-wenn-Ergebnisressourcen-ID.
Der Name des Bereitstellungsstapels was-wäre-wenn-Ergebnis.
Deaktivieren Sie die Farbe in ziemlich gedruckten Was-wäre-wenn-Ergebnissen.
Deaktivieren Sie "Pretty Print" für What-If Ergebnisse. Bei Festlegung wird der Ausgabeformattyp verwendet.
Kennzeichnen, um die What-If Ergebnisse mit eingeschlossenen Ressourceneigenschaftenänderungen zurückzugeben.
| Eigenschaft | Wert |
|---|---|
| Zulässige Werte: | false, true |
Globale Parameter
Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Diese Hilfemeldung anzeigen und schließen.
Nur Fehler anzeigen, Warnungen unterdrücken.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |
Ausgabeformat.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | json |
| Zulässige Werte: | json, jsonc, none, table, tsv, yaml, yamlc |
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_IDkonfigurieren.
Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.
| Eigenschaft | Wert |
|---|---|
| Standardwert: | False |