Freigeben über

az deployment tenant

  • Referenz

Verwalten sie die Azure Resource Manager-Vorlagenbereitstellung auf Mandantenebene.

Befehle

Name Beschreibung Typ Status
az deployment tenant cancel

Abbrechen einer Bereitstellung auf Mandantenebene.

 Kernspeicher Allgemein verfügbar
az deployment tenant create

Starten Sie eine Bereitstellung im Mandantenbereich.

 Kernspeicher Allgemein verfügbar
az deployment tenant delete

Löschen sie eine Bereitstellung im Mandantenbereich.

 Kernspeicher Allgemein verfügbar
az deployment tenant export

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

 Kernspeicher Allgemein verfügbar
az deployment tenant list

Auflisten von Bereitstellungen auf Mandantenebene.

 Kernspeicher Allgemein verfügbar
az deployment tenant show

Anzeigen einer Bereitstellung im Mandantenbereich.

 Kernspeicher Allgemein verfügbar
az deployment tenant validate

Überprüfen Sie, ob eine Vorlage im Mandantenbereich gültig ist.

 Kernspeicher Allgemein verfügbar
az deployment tenant wait

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

 Kernspeicher Allgemein verfügbar
az deployment tenant what-if

Führen Sie einen Bereitstellungs-What-If-Vorgang im Mandantenbereich aus.

 Kernspeicher Allgemein verfügbar

az deployment tenant cancel

Bearbeiten

Abbrechen einer Bereitstellung auf Mandantenebene.

az deployment tenant cancel --name

Beispiele

Abbrechen einer Bereitstellung auf Mandantenebene.

az deployment tenant cancel -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

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 deployment tenant create

Bearbeiten

Starten Sie eine Bereitstellung im Mandantenbereich.

Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.

az deployment tenant create --location
                            [--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 im Mandantenbereich aus einer Remotevorlagendatei mithilfe von Parametern aus einer lokalen JSON-Datei.

az deployment tenant create --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Erstellen Sie eine Bereitstellung im Mandantenbereich aus einer lokalen Vorlagendatei mithilfe von Parametern aus einer JSON-Zeichenfolge.

az deployment tenant create --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Erstellen Sie eine Bereitstellung im Mandantenbereich über eine lokale Vorlage, mithilfe einer Parameterdatei, einer Remoteparameterdatei und selektiver Außerkraftsetzung von Schlüssel-Wert-Paaren.

az deployment tenant create --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.

Optionale Parameter

--confirm-with-what-if -c

Weisen Sie den Befehl an, die Bereitstellungs-Was-Wenn 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.

--name -n

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

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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

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

--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 Den-Wäre-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 der Was-Wäre-Ergebnisse. Gilt, wenn --confirm-with-what-if festgelegt wird.

Zulässige Werte: FullResourcePayloads, ResourceIdOnly
Standardwert: FullResourcePayloads
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 deployment tenant delete

Bearbeiten

Löschen sie eine Bereitstellung im Mandantenbereich.

az deployment tenant delete --name
                            [--no-wait]

Beispiele

Löschen sie eine Bereitstellung im Mandantenbereich.

az deployment tenant delete -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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 deployment tenant export

Bearbeiten

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

az deployment tenant export --name

Beispiele

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

az deployment tenant export --name MyDeployment

Erforderliche Parameter

--name -n

Bereitstellungsname

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 deployment tenant list

Bearbeiten

Auflisten von Bereitstellungen auf Mandantenebene.

az deployment tenant list [--filter]

Beispiele

Auflisten von Bereitstellungen auf Mandantenebene.

az deployment tenant list

Optionale Parameter

--filter
Vorschau

Filterausdruck mit OData-Notation. Sie können "provisioningState eq '{state}'" verwenden, um provisioningState zu filtern. Um weitere Informationen zu erhalten, besuchen https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parametersSie bitte .

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 deployment tenant show

Bearbeiten

Anzeigen einer Bereitstellung im Mandantenbereich.

az deployment tenant show --name

Beispiele

Anzeigen einer Bereitstellung im Mandantenbereich.

az deployment tenant show -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

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 deployment tenant validate

Bearbeiten

Überprüfen Sie, ob eine Vorlage im Mandantenbereich gültig ist.

Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.

az deployment tenant validate --location
                              [--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 im Mandantenbereich gültig ist.

az deployment tenant validate --location WestUS --template-file {template-file}

Überprüfen Sie, ob eine Vorlage im Mandantenbereich gültig ist. (automatisch generiert)

az deployment tenant validate --location WestUS --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Erforderliche Parameter

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

Optionale Parameter

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

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

Zulässige Werte: false, true
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=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.

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

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 deployment tenant wait

Bearbeiten

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

az deployment tenant wait --name
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--interval]
                          [--timeout]
                          [--updated]

Beispiele

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

az deployment tenant wait --deleted --name MyDeployment

Erforderliche Parameter

--name -n

Bereitstellungsname

Optionale Parameter

--created

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

Standardwert: False
--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.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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

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 deployment tenant what-if

Bearbeiten

Führen Sie einen Bereitstellungs-What-If-Vorgang im Mandantenbereich aus.

Geben Sie bitte nur eine datei --template-file | --template-uri URI | --template-spec to input the ARM template.

az deployment tenant what-if --location
                             [--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 einen Bereitstellungs-What-If-Vorgang im Mandantenbereich aus.

az deployment tenant what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Führen Sie einen Bereitstellungs-What-If-Vorgang im Mandantenbereich mit dem ResourceIdOnly-Format aus.

az deployment tenant what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Führen Sie einen Was-If-Bereitstellungsvorgang im Mandantenbereich aus, ohne das Ergebnis ziemlich zu drucken.

az deployment tenant what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Erforderliche Parameter

--location -l

Der Speicherort zum Speichern der Metadaten des Bereitstellungs-What-If-Vorgangs.

Optionale Parameter

--exclude-change-types -x

Durch Leerzeichen getrennte Liste der Ressourcenänderungstypen, die von Den-Wäre-Ergebnissen ausgeschlossen werden sollen.

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

Bereitstellungsname

--no-pretty-print

Deaktivieren Sie "Hübsches Drucken" für Was-Wäre-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“.

Zulässige Werte: false, true
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=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.

--result-format -r

Das Format der Was-Wäre-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.

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.