Share via

az stack sub

  • Referenz

Verwalten von Bereitstellungsstapeln im Abonnement.

Befehle

Name Beschreibung Typ Status
az stack sub create

Erstellen oder Aktualisieren eines Bereitstellungsstapels im Abonnementbereich.

 Core Allgemein verfügbar
az stack sub delete

Löschen des angegebenen Bereitstellungsstapels aus Abonnementbereich.

 Core Allgemein verfügbar
az stack sub export

Exportieren Sie die Vorlage, die zum Erstellen des Bereitstellungsstapels verwendet wird.

 Core Allgemein verfügbar
az stack sub list

Listet alle Bereitstellungsstapel im Abonnement auf.

 Core Allgemein verfügbar
az stack sub show

Rufen Sie den angegebenen Bereitstellungsstapel aus dem Abonnementbereich ab.

 Core Allgemein verfügbar
az stack sub validate

Überprüfen eines Bereitstellungsstapels im Abonnementbereich.

 Core Allgemein verfügbar

az stack sub create

Erstellen oder Aktualisieren eines Bereitstellungsstapels im Abonnementbereich.

az stack sub create --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                    --location
                    --name
                    [--bse {false, true}]
                    [--cs]
                    [--deny-settings-excluded-actions]
                    [--deny-settings-excluded-principals]
                    [--deployment-resource-group]
                    [--description]
                    [--no-wait]
                    [--parameters]
                    [--query-string]
                    [--tags]
                    [--template-file]
                    [--template-spec]
                    [--template-uri]
                    [--yes]

Beispiele

Erstellen Sie einen Bereitstellungsstapel mithilfe der Vorlagendatei, und trennen Sie alle Ressourcen für die nicht verwaltete Datei.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

Erstellen Sie einen Bereitstellungsstapel mit Parameterdatei, und löschen Sie Ressourcen, die nicht verwaltet werden.

az stack sub create --name StackName --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

Erstellen Sie einen Bereitstellungsstapel mit Vorlagenspezifikation.

az stack sub create --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

Erstellen Sie einen Bereitstellungsstapel mithilfe der Bicep-Datei, und löschen Sie alle Ressourcen, die nicht verwaltet werden.

az stack sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Erstellen Sie einen Bereitstellungsstapel in einem anderen Abonnement.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

Erstellen Sie einen Bereitstellungsstapel, und stellen Sie sie im Ressourcengruppenbereich bereit.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

Erstellen Sie einen Bereitstellungsstapel mithilfe von Parametern aus Schlüssel-Wert-Paaren.

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

Erstellen Sie einen Bereitstellungsstapel aus einer lokalen Vorlage mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiven Überschreiben von Schlüssel-Wert-Paaren.

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

Erstellen Sie einen Bereitstellungsstapel aus einer lokalen Vorlage mithilfe von Verweigerneinstellungen.

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

Erstellen Sie einen Bereitstellungsstapel aus einer lokalen Vorlage, wenden Sie Verweigerungseinstellungen auf untergeordnete Bereiche an.

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

Erforderliche Parameter

--action-on-unmanage --aou

Definiert, was mit Ressourcen geschieht, die nicht mehr verwaltet werden, nachdem der Stapel aktualisiert oder gelöscht wurde.

Zulässige Werte: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Definieren Sie, welche Vorgänge für vom Stapel verwaltete Ressourcen verweigert werden.

Zulässige Werte: denyDelete, denyWriteAndDelete, none
--location -l

Der Speicherort zum Speichern des Bereitstellungsstapels.

--name -n

Der Name des Bereitstellungsstapels.

Optionale Parameter

--bse --bypass-stack-out-of-sync-error

Flag zum Umgehen von Dienstfehlern, die angeben, dass die Stapelressourcenliste nicht ordnungsgemäß synchronisiert ist.

Zulässige Werte: false, true
Standardwert: False
--cs --deny-settings-apply-to-child-scopes

Deny Einstellungen wird auf untergeordnete Bereiche angewendet.

Standardwert: False
--deny-settings-excluded-actions --ea

Liste der rollenbasierten Verwaltungsvorgänge, die von der Verweigerung ausgeschlossen sind Einstellungen. Bis zu 200 Aktionen sind zulässig.

--deny-settings-excluded-principals --ep

Liste der von der Sperre ausgeschlossenen AAD-Prinzipal-IDs. Bis zu 5 Prinzipale sind zulässig.

--deployment-resource-group --dr

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.

--description

Die Beschreibung des Bereitstellungsstapels.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--parameters -p

Parameter können aus einer Datei mithilfe der @{path} Syntax, einer JSON-Zeichenfolge oder als <KEY=WERT-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.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--template-file -f

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

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Ein URI für eine Remotevorlagendatei.

--yes

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az stack sub delete

Löschen des angegebenen Bereitstellungsstapels aus Abonnementbereich.

az stack sub delete --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    [--bse {false, true}]
                    [--id]
                    [--name]
                    [--yes]

Beispiele

Stapel nach Name löschen.

az stack sub delete --name StackName --action-on-unmanage deleteResources

Stapel nach Stapelressourcen-ID löschen.

az stack sub delete --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName --action-on-unmanage detachAll

Erforderliche Parameter

--action-on-unmanage --aou

Definiert, was mit Ressourcen geschieht, die nicht mehr verwaltet werden, nachdem der Stapel aktualisiert oder gelöscht wurde.

Zulässige Werte: deleteAll, deleteResources, detachAll

Optionale Parameter

--bse --bypass-stack-out-of-sync-error

Flag zum Umgehen von Dienstfehlern, die angeben, dass die Stapelressourcenliste nicht ordnungsgemäß synchronisiert ist.

Zulässige Werte: false, true
Standardwert: False
--id

Die Ressourcen-ID des Bereitstellungsstapels.

--name -n

Der Name des Bereitstellungsstapels.

--yes

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az stack sub export

Exportieren Sie die Vorlage, die zum Erstellen des Bereitstellungsstapels verwendet wird.

az stack sub export [--id]
                    [--name]

Beispiele

Vorlage anhand des Namens exportieren.

az stack sub export --name StackName

Exportieren Sie die Vorlage nach Stapelressourcen-ID.

az stack sub export --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

Optionale Parameter

--id

Die Ressourcen-ID des Bereitstellungsstapels.

--name -n

Der Name des Bereitstellungsstapels.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az stack sub list

Listet alle Bereitstellungsstapel im Abonnement auf.

az stack sub list

Beispiele

Auflisten aller Stapel

az stack sub list
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az stack sub show

Rufen Sie den angegebenen Bereitstellungsstapel aus dem Abonnementbereich ab.

az stack sub show [--id]
                  [--name]

Beispiele

Abrufen des Stapels nach Name.

az stack sub show --name StackName

Stapel nach Stapelressourcen-ID abrufen.

az stack sub show --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

Optionale Parameter

--id

Die Ressourcen-ID des Bereitstellungsstapels.

--name -n

Der Name des Bereitstellungsstapels.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az stack sub validate

Überprüfen eines Bereitstellungsstapels im Abonnementbereich.

az stack sub validate --action-on-unmanage {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                      --location
                      --name
                      [--bse {false, true}]
                      [--cs]
                      [--deny-settings-excluded-actions]
                      [--deny-settings-excluded-principals]
                      [--deployment-resource-group]
                      [--description]
                      [--parameters]
                      [--query-string]
                      [--tags]
                      [--template-file]
                      [--template-spec]
                      [--template-uri]

Beispiele

Überprüfen Sie einen Bereitstellungsstapel mithilfe der Vorlagendatei, und trennen Sie alle Ressourcen für die nicht verwaltete Datei.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

Überprüfen Eines Bereitstellungsstapels mit Parameterdatei und Löschen von Ressourcen bei nicht verwalteter Datei.

az stack sub validate --name StackName --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

Überprüfen eines Bereitstellungsstapels mit Vorlagenspezifikation.

az stack sub validate --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

Überprüfen Sie einen Bereitstellungsstapel mithilfe der Bicep-Datei, und löschen Sie alle Ressourcen, die nicht verwaltet werden.

az stack sub validate --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Überprüfen eines Bereitstellungsstapels bei einem anderen Abonnement.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

Überprüfen Sie einen Bereitstellungsstapel, und stellen Sie sie im Ressourcengruppenbereich bereit.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

Überprüfen eines Bereitstellungsstapels mithilfe von Parametern aus Schlüssel-Wert-Paaren.

az stack sub validate --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

Überprüfen Eines Bereitstellungsstapels aus einer lokalen Vorlage mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiver Außerkraftsetzung von Schlüssel-Wert-Paaren.

az stack sub validate --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

Überprüfen Eines Bereitstellungsstapels aus einer lokalen Vorlage mithilfe von Verweigerungseinstellungen.

az stack sub validate --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

Überprüfen Sie einen Bereitstellungsstapel aus einer lokalen Vorlage, und wenden Sie Verweigerungseinstellungen auf untergeordnete Bereiche an.

az stack sub validate --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

Erforderliche Parameter

--action-on-unmanage --aou

Definiert, was mit Ressourcen geschieht, die nicht mehr verwaltet werden, nachdem der Stapel aktualisiert oder gelöscht wurde.

Zulässige Werte: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Definieren Sie, welche Vorgänge für vom Stapel verwaltete Ressourcen verweigert werden.

Zulässige Werte: denyDelete, denyWriteAndDelete, none
--location -l

Der Speicherort zum Speichern des Bereitstellungsstapels.

--name -n

Der Name des Bereitstellungsstapels.

Optionale Parameter

--bse --bypass-stack-out-of-sync-error

Flag zum Umgehen von Dienstfehlern, die angeben, dass die Stapelressourcenliste nicht ordnungsgemäß synchronisiert ist.

Zulässige Werte: false, true
Standardwert: False
--cs --deny-settings-apply-to-child-scopes

Deny Einstellungen wird auf untergeordnete Bereiche angewendet.

Standardwert: False
--deny-settings-excluded-actions --ea

Liste der rollenbasierten Verwaltungsvorgänge, die von der Verweigerung ausgeschlossen sind Einstellungen. Bis zu 200 Aktionen sind zulässig.

--deny-settings-excluded-principals --ep

Liste der von der Sperre ausgeschlossenen AAD-Prinzipal-IDs. Bis zu 5 Prinzipale sind zulässig.

--deployment-resource-group --dr

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.

--description

Die Beschreibung des Bereitstellungsstapels.

--parameters -p

Parameter können aus einer Datei mithilfe der @{path} Syntax, einer JSON-Zeichenfolge oder als <KEY=WERT-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.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--template-file -f

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

--template-spec -s

Die Ressourcen-ID der Vorlage.

--template-uri -u

Ein URI für eine Remotevorlagendatei.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.