Feedback

az deployment sub

  • Referenz

Verwalten der Azure-Resource Manager-Vorlagenbereitstellung im Abonnementbereich.

Befehle

az deployment sub cancel

Kündigen einer Bereitstellung im Abonnementbereich.
az deployment sub create

Starten Sie eine Bereitstellung im Abonnementbereich.
az deployment sub delete

Löschen einer Bereitstellung im Abonnementbereich.
az deployment sub export

Exportiert die für die Bereitstellung verwendete Vorlage.
az deployment sub list

Auflisten von Bereitstellungen im Abonnementbereich.
az deployment sub show

Anzeigen einer Bereitstellung im Abonnementbereich.
az deployment sub validate

Überprüfen Sie, ob eine Vorlage im Abonnementbereich gültig ist.
az deployment sub wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bereitstellungsbedingung erfüllt ist.
az deployment sub what-if

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

az deployment sub cancel

Bearbeiten

Kündigen einer Bereitstellung im Abonnementbereich.

az deployment sub cancel --name

Beispiele

Kündigen einer Bereitstellung im Abonnementbereich.

az deployment sub cancel -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

az deployment sub create

Bearbeiten

Starten Sie eine Bereitstellung im Abonnementbereich.

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

az deployment sub 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 Abonnementbereich aus einer Remotevorlagendatei mithilfe von Parametern aus einer lokalen JSON-Datei.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

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

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

az deployment sub create --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 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 mehrlineer und Kommentare in der Bereitstellung.

--name -n

Bereitstellungsname

--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
--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 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, Bereitstellungs-What-If auszuführen.

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

Leerzeichentrennte 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 What-If Ergebnisse. Anwendbar, wenn --confirm-with-what-if festgelegt wird.

Zulässige Werte: FullResourcePayloads, ResourceIdOnly
Standardwert: FullResourcePayloads

az deployment sub delete

Bearbeiten

Löschen einer Bereitstellung im Abonnementbereich.

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

Beispiele

Löschen einer Bereitstellung im Abonnementbereich.

az deployment sub delete -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

az deployment sub export

Bearbeiten

Exportiert die für die Bereitstellung verwendete Vorlage.

az deployment sub export --name

Beispiele

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

az deployment sub export --name MyDeployment

Erforderliche Parameter

--name -n

Bereitstellungsname

az deployment sub list

Bearbeiten

Auflisten von Bereitstellungen im Abonnementbereich.

az deployment sub list [--filter]

Beispiele

Auflisten von Bereitstellungen im Abonnementbereich.

az deployment sub list

Optionale Parameter

--filter

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

az deployment sub show

Bearbeiten

Anzeigen einer Bereitstellung im Abonnementbereich.

az deployment sub show --name

Beispiele

Anzeigen einer Bereitstellung im Abonnementbereich.

az deployment sub show -n deployment01

Erforderliche Parameter

--name -n

Bereitstellungsname

az deployment sub validate

Bearbeiten

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

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

az deployment sub 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 Abonnementbereich gültig ist.

az deployment sub validate --location westus2 --template-file {template-file}

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

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Erforderliche Parameter

--location -l

Der Speicherort zum Speichern der Bereitstellungsmetadaten.

Optionale Parameter

--handle-extended-json-format -j

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

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

az deployment sub wait

Bearbeiten

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

az deployment sub 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 sub wait --created --name MyDeployment

Erforderliche Parameter

--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 sie mit provisioningState unter "Erfolgreich" aktualisiert wurde.

az deployment sub what-if

Bearbeiten

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

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

az deployment sub 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 eine Bereitstellung What-If Operation bei einem Abonnement aus.

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

Führen Sie einen Bereitstellungsvorgang What-If bei einem Abonnement mit dem ResourceIdOnly-Format aus.

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

Führen Sie eine Bereitstellung What-If Operation bei einem Abonnement aus, ohne das Ergebnis ziemlich zu drucken.

az deployment sub 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 Bereitstellung What-If Vorgangsmetadaten.

Optionale Parameter

--exclude-change-types -x

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

--result-format -r

Das Format von What-If Ergebnissen.

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 für die Vorlagendatei.