Udostępnij za pośrednictwem

az deployment sub

  • Odwołanie

Zarządzanie wdrożeniem szablonu usługi Azure Resource Manager w zakresie subskrypcji.

Polecenia

Nazwa Opis Typ Stan
az deployment sub cancel

Anulowanie wdrożenia w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność
az deployment sub create

Rozpocznij wdrożenie w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność
az deployment sub delete

Usuń wdrożenie w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność
az deployment sub export

Wyeksportuj szablon używany do wdrożenia.

 Podstawowe funkcje Ogólna dostępność
az deployment sub list

Wyświetlanie listy wdrożeń w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność
az deployment sub show

Pokaż wdrożenie w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność
az deployment sub validate

Sprawdź, czy szablon jest prawidłowy w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność
az deployment sub wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku wdrożenia.

 Podstawowe funkcje Ogólna dostępność
az deployment sub what-if

Wykonaj operację analizy co-jeżeli wdrożenia w zakresie subskrypcji.

 Podstawowe funkcje Ogólna dostępność

az deployment sub cancel

Edytuj

Anulowanie wdrożenia w zakresie subskrypcji.

az deployment sub cancel --name

Przykłady

Anulowanie wdrożenia w zakresie subskrypcji.

az deployment sub cancel -n deployment01

Parametry wymagane

--name -n

Nazwa wdrożenia.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub create

Edytuj

Rozpocznij wdrożenie w zakresie subskrypcji.

Określ tylko jeden plik --template-file | --template-uri URI | --template-spec do wprowadzania szablonu usługi ARM.

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

Przykłady

Utwórz wdrożenie w zakresie subskrypcji na podstawie pliku szablonu zdalnego przy użyciu parametrów z lokalnego pliku JSON.

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

Utwórz wdrożenie w zakresie subskrypcji na podstawie pliku szablonu lokalnego przy użyciu parametrów z ciągu JSON.

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

Utwórz wdrożenie w zakresie subskrypcji na podstawie szablonu lokalnego przy użyciu pliku parametrów, pliku parametrów zdalnych i selektywnie przesłaniania par klucz/wartość.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Parametry wymagane

--location -l

Lokalizacja do przechowywania metadanych wdrożenia.

Parametry opcjonalne

--confirm-with-what-if -c

Poinstruuj polecenie , aby uruchomić wdrożenie What-If przed wykonaniem wdrożenia. Następnie wyświetla monit o potwierdzenie zmian zasobów przed kontynuowaniem.

--handle-extended-json-format -j
Przestarzałe

Opcja "--handle-extended-json-format/-j" została wycofana i zostanie usunięta w przyszłej wersji.

Obsługa obsługi rozszerzonej zawartości szablonu, w tym wielowierszowych i komentarzy we wdrożeniu.

--name -n

Nazwa wdrożenia.

--no-prompt

Opcja wyłączenia monitu o brakujące parametry dla szablonu usługi ARM. Jeśli wartość ma wartość true, monit wymagający od użytkowników podania brakującego parametru zostanie zignorowany. Wartość domyślna to false.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Domyślna wartość: False
--parameters -p

Podaj wartości parametrów wdrożenia.

Parametry mogą być dostarczane z pliku przy użyciu @{path} składni, ciągu JSON lub jako <par KEY=VALUE> . Parametry są obliczane w kolejności, więc gdy wartość zostanie przypisana dwukrotnie, zostanie użyta ta ostatnia wartość. Zaleca się najpierw podanie pliku parametrów, a następnie selektywne zastąpienie przy użyciu składni KEY=VALUE.

--proceed-if-no-change

Poinstruuj polecenie , aby wykonać wdrożenie, jeśli wynik analizy co-jeżeli nie zawiera żadnych zmian zasobów. Ma zastosowanie w przypadku ustawienia --confirm-with-what-if.

--query-string -q

Ciąg zapytania (token SAS), który ma być używany z identyfikatorem URI szablonu w przypadku połączonych szablonów.

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

Identyfikator URI do pliku szablonu.

--what-if -w

Poinstruuj polecenie , aby uruchomić wdrożenie What-If.

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

Rozdzielona spacjami lista typów zmian zasobów, które mają zostać wykluczone z wyników analizy warunkowej. Ma zastosowanie w przypadku ustawienia --confirm-with-what-if.

Dopuszczalne wartości: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Format wyników analizy co-jeżeli. Ma zastosowanie w przypadku --confirm-with-what-if ustawienia.

Dopuszczalne wartości: FullResourcePayloads, ResourceIdOnly
Domyślna wartość: FullResourcePayloads
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub delete

Edytuj

Usuń wdrożenie w zakresie subskrypcji.

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

Przykłady

Usuń wdrożenie w zakresie subskrypcji.

az deployment sub delete -n deployment01

Parametry wymagane

--name -n

Nazwa wdrożenia.

Parametry opcjonalne

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub export

Edytuj

Wyeksportuj szablon używany do wdrożenia.

az deployment sub export --name

Przykłady

Wyeksportuj szablon używany do wdrożenia w zakresie subskrypcji.

az deployment sub export --name MyDeployment

Parametry wymagane

--name -n

Nazwa wdrożenia.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub list

Edytuj

Wyświetlanie listy wdrożeń w zakresie subskrypcji.

az deployment sub list [--filter]

Przykłady

Wyświetlanie listy wdrożeń w zakresie subskrypcji.

az deployment sub list

Parametry opcjonalne

--filter
Wersja zapoznawcza

Wyrażenie filtru przy użyciu notacji OData. Możesz użyć --filter "provisioningState eq "{state}", aby filtrować provisioningState. Aby uzyskać więcej informacji, odwiedź stronę https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub show

Edytuj

Pokaż wdrożenie w zakresie subskrypcji.

az deployment sub show --name

Przykłady

Pokaż wdrożenie w zakresie subskrypcji.

az deployment sub show -n deployment01

Parametry wymagane

--name -n

Nazwa wdrożenia.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub validate

Edytuj

Sprawdź, czy szablon jest prawidłowy w zakresie subskrypcji.

Określ tylko jeden plik --template-file | --template-uri URI | --template-spec do wprowadzania szablonu usługi ARM.

az deployment sub validate --location
                           [--handle-extended-json-format]
                           [--name]
                           [--no-prompt {false, true}]
                           [--parameters]
                           [--query-string]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]

Przykłady

Sprawdź, czy szablon jest prawidłowy w zakresie subskrypcji.

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

Sprawdź, czy szablon jest prawidłowy w zakresie subskrypcji. (automatycznie wygenerowane)

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

Parametry wymagane

--location -l

Lokalizacja do przechowywania metadanych wdrożenia.

Parametry opcjonalne

--handle-extended-json-format -j
Przestarzałe

Opcja "--handle-extended-json-format/-j" została wycofana i zostanie usunięta w przyszłej wersji.

Obsługa obsługi rozszerzonej zawartości szablonu, w tym wielowierszowych i komentarzy we wdrożeniu.

--name -n

Nazwa wdrożenia.

--no-prompt

Opcja wyłączenia monitu o brakujące parametry dla szablonu usługi ARM. Jeśli wartość ma wartość true, monit wymagający od użytkowników podania brakującego parametru zostanie zignorowany. Wartość domyślna to false.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--parameters -p

Podaj wartości parametrów wdrożenia.

Parametry mogą być dostarczane z pliku przy użyciu @{path} składni, ciągu JSON lub jako <par KEY=VALUE> . Parametry są obliczane w kolejności, więc gdy wartość zostanie przypisana dwukrotnie, zostanie użyta ta ostatnia wartość. Zaleca się najpierw podanie pliku parametrów, a następnie selektywne zastąpienie przy użyciu składni KEY=VALUE.

--query-string -q

Ciąg zapytania (token SAS), który ma być używany z identyfikatorem URI szablonu w przypadku połączonych szablonów.

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

Identyfikator URI do pliku szablonu.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub wait

Edytuj

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku wdrożenia.

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

Przykłady

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku wdrożenia. (automatycznie wygenerowane)

az deployment sub wait --created --name MyDeployment

Parametry wymagane

--name -n

Nazwa wdrożenia.

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Domyślna wartość: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Poczekaj na usunięcie.

Domyślna wartość: False
--exists

Zaczekaj, aż zasób istnieje.

Domyślna wartość: False
--interval

Interwał sondowania w sekundach.

Domyślna wartość: 30
--timeout

Maksymalny czas oczekiwania w sekundach.

Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az deployment sub what-if

Edytuj

Wykonaj operację analizy co-jeżeli wdrożenia w zakresie subskrypcji.

Określ tylko jeden plik --template-file | --template-uri URI | --template-spec do wprowadzania szablonu usługi ARM.

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]

Przykłady

Wykonaj operację analizy co-jeżeli wdrożenia w subskrypcji.

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

Wykonaj operację analizy co-jeżeli wdrożenia w subskrypcji w formacie ResourceIdOnly.

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

Wykonaj operację analizy co-jeżeli wdrożenia w subskrypcji bez konieczności drukowania wyniku.

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

Parametry wymagane

--location -l

Lokalizacja do przechowywania metadanych operacji analizy co-jeżeli wdrożenia.

Parametry opcjonalne

--exclude-change-types -x

Rozdzielona spacjami lista typów zmian zasobów, które mają zostać wykluczone z wyników analizy warunkowej.

Dopuszczalne wartości: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Nazwa wdrożenia.

--no-pretty-print

Wyłącz funkcję pretty-print w przypadku wyników analizy co-jeżeli. Po ustawieniu zostanie użyty typ formatu danych wyjściowych.

--no-prompt

Opcja wyłączenia monitu o brakujące parametry dla szablonu usługi ARM. Jeśli wartość ma wartość true, monit wymagający od użytkowników podania brakującego parametru zostanie zignorowany. Wartość domyślna to false.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--parameters -p

Podaj wartości parametrów wdrożenia.

Parametry mogą być dostarczane z pliku przy użyciu @{path} składni, ciągu JSON lub jako <par KEY=VALUE> . Parametry są obliczane w kolejności, więc gdy wartość zostanie przypisana dwukrotnie, zostanie użyta ta ostatnia wartość. Zaleca się najpierw podanie pliku parametrów, a następnie selektywne zastąpienie przy użyciu składni KEY=VALUE.

--query-string -q

Ciąg zapytania (token SAS), który ma być używany z identyfikatorem URI szablonu w przypadku połączonych szablonów.

--result-format -r

Format wyników analizy co-jeżeli.

Dopuszczalne wartości: FullResourcePayloads, ResourceIdOnly
Domyślna wartość: FullResourcePayloads
--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

Identyfikator URI do pliku szablonu.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.