az deployment group

Zarządzanie Azure Resource Manager szablonu w grupie zasobów.

Polecenia

az deployment group cancel

Anulowanie wdrożenia w grupie zasobów.

az deployment group create

Rozpocznij wdrożenie w grupie zasobów.

az deployment group delete

Usuń wdrożenie w grupie zasobów.

az deployment group export

Eksportuj szablon używany do wdrożenia.

az deployment group list

Lista wdrożeń w grupie zasobów.

az deployment group show

Wyświetlanie wdrożenia w grupie zasobów.

az deployment group validate

Sprawdź, czy szablon jest prawidłowy w grupie zasobów.

az deployment group wait

Umieść interfejs wiersza polecenia w stanie oczekiwania, dopóki nie zostanie spełniony warunek wdrożenia.

az deployment group what-if

Wykonaj operację wdrażania What-If w zakresie grupy zasobów.

az deployment group cancel

Anulowanie wdrożenia w grupie zasobów.

az deployment group cancel --name
                           --resource-group
                           [--subscription]

Przykłady

Anulowanie wdrożenia w grupie zasobów.

az deployment group cancel -g testrg -n deployment01

Parametry wymagane

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu narzędzia az configure --defaults group=<name> .

Parametry opcjonalne

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

az deployment group create

Rozpocznij wdrożenie w grupie zasobów.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--subscription]
                           [--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 grupie zasobów na podstawie zdalnego pliku szablonu przy użyciu parametrów z lokalnego pliku JSON.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Utwórz wdrożenie w grupie zasobów na podstawie lokalnego pliku szablonu przy użyciu parametrów z ciągu tablicy.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Utwórz wdrożenie w grupie zasobów na podstawie szablonu lokalnego, używając pliku parametrów, pliku parametrów zdalnych i selektywnie przesłaniając pary klucz/wartość.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Tworzenie wdrożenia w zakresie subskrypcji na podstawie specyfikacji szablonu

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Parametry wymagane

--resource-group -g

Grupa zasobów do utworzenia wdrożenia w programie .

Parametry opcjonalne

--aux-subs

Subskrypcje pomocnicze, które będą używane podczas wdrażania w dzierżawach.

--aux-tenants

Dzierżawy pomocnicze, które będą używane podczas wdrażania między dzierżawami.

--confirm-with-what-if -c

Poinstruuj polecenie, aby What-If wdrożenia przed jego wdrożeniem. Następnie zostanie wyświetlony monit o potwierdzenie zmian zasobów przed kontynuowaniem.

--handle-extended-json-format -j

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

--mode

Tryb wdrażania.

akceptowane wartości: Complete, Incremental
wartość domyślna: Incremental
--name -n

Nazwa wdrożenia.

--no-prompt

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

akceptowane wartości: false, true
--no-wait

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

--parameters -p

Należy podać wartości parametrów wdrożenia.

--proceed-if-no-change

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

--query-string -q

Ciąg zapytania (token SAS) do użycia z szablonem URI w przypadku połączonych szablonów.

--rollback-on-error

Nazwa wdrożenia, do których ma na celu powrót po błędzie, lub użyj flagi w celu powrotu do ostatniego pomyślnego wdrożenia.

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

URI pliku szablonu.

--what-if -w

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

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

Rozdzielana spacjami lista typów zmian zasobów, które mają być wykluczone z What-If wyników. Ma zastosowanie w przypadku ustawienia --confirm-with-what-if.

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

Format What-If danych. Ma zastosowanie, --confirm-with-what-if gdy jest ustawiona.

akceptowane wartości: FullResourcePayloads, ResourceIdOnly
wartość domyślna: FullResourcePayloads

az deployment group delete

Usuń wdrożenie w grupie zasobów.

az deployment group delete --name
                           --resource-group
                           [--no-wait]
                           [--subscription]

Przykłady

Usuń wdrożenie w grupie zasobów.

az deployment group delete -g testrg -n deployment01

Parametry wymagane

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu narzędzia az configure --defaults group=<name> .

Parametry opcjonalne

--no-wait

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

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

az deployment group export

Eksportuj szablon używany do wdrożenia.

az deployment group export --name
                           --resource-group
                           [--subscription]

Przykłady

Wyeksportuj szablon używany do wdrożenia w grupie zasobów.

az deployment group export --resource-group testrg --name MyDeployment

Parametry wymagane

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu narzędzia az configure --defaults group=<name> .

Parametry opcjonalne

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

az deployment group list

Lista wdrożeń w grupie zasobów.

az deployment group list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]

Przykłady

Lista wdrożeń w grupie zasobów.

az deployment group list -g testrg

Parametry wymagane

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu narzędzia az configure --defaults group=<name> .

Parametry opcjonalne

--filter

Filtrowanie wyrażenia przy użyciu notacji OData. Możesz użyć --filter "provisioningState eq '{state}'" do filtrowania provisioningState. Aby uzyskać więcej informacji, odwiedź stronę https://docs.microsoft.com/en-us/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters .

--query-examples

Zalecane jest użycie ciągu JMESPath. Możesz skopiować jedno z zapytań i wkleić je po parametrze --query w podwójnych cudzysłowach, aby wyświetlić wyniki. Możesz dodać jedno lub więcej słów kluczowych pozytywnych, dzięki czemu będziemy w stanie dawać sugestie na podstawie tych słów kluczowych.

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

az deployment group show

Wyświetlanie wdrożenia w grupie zasobów.

az deployment group show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

Przykłady

Wyświetlanie wdrożenia w grupie zasobów.

az deployment group show -g testrg -n deployment01

Parametry wymagane

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu narzędzia az configure --defaults group=<name> .

Parametry opcjonalne

--query-examples

Zalecane jest użycie ciągu JMESPath. Możesz skopiować jedno z zapytań i wkleić je po parametrze --query w podwójnych cudzysłowach, aby wyświetlić wyniki. Możesz dodać jedno lub więcej słów kluczowych pozytywnych, dzięki czemu będziemy w stanie dawać sugestie na podstawie tych słów kluczowych.

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

az deployment group validate

Sprawdź, czy szablon jest prawidłowy w grupie zasobów.

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--subscription]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Przykłady

Sprawdź, czy szablon jest prawidłowy w grupie zasobów.

az deployment group validate --resource-group testrg --template-file {template-file}

Sprawdź, czy szablon jest prawidłowy w grupie zasobów. (wygenerowane automatycznie)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Parametry wymagane

--resource-group -g

Grupa zasobów do utworzenia wdrożenia w programie .

Parametry opcjonalne

--handle-extended-json-format -j

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

--mode

Tryb wdrażania.

akceptowane wartości: Complete, Incremental
wartość domyślna: Incremental
--name -n

Nazwa wdrożenia.

--no-prompt

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

akceptowane wartości: false, true
--parameters -p

Należy podać wartości parametrów wdrożenia.

--query-string -q

Ciąg zapytania (token SAS) do użycia z szablonem URI w przypadku połączonych szablonów.

--rollback-on-error

Nazwa wdrożenia, do których ma na celu powrót po błędzie, lub użyj flagi w celu powrotu do ostatniego pomyślnego wdrożenia.

--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

URI pliku szablonu.

az deployment group wait

Umieść interfejs wiersza polecenia w stanie oczekiwania, dopóki nie zostanie spełniony warunek wdrożenia.

az deployment group wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--subscription]
                         [--timeout]
                         [--updated]

Przykłady

Umieść interfejs wiersza polecenia w stanie oczekiwania, dopóki nie zostanie spełniony warunek wdrożenia. (wygenerowane automatycznie)

az deployment group wait --created --name MyDeployment --resource-group MyResourceGroup

Parametry wymagane

--name -n

Nazwa wdrożenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu narzędzia az configure --defaults group=<name> .

Parametry opcjonalne

--created

Poczekaj, aż zostanie utworzony za pomocą "provisioningState" w stanie "Succeeded".

--custom

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

--deleted

Poczekaj na usunięcie.

--exists

Zaczekaj, aż zasób istnieje.

--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na zaktualizowanie przy użyciu stanu provisioningState w stanie "Succeeded".

az deployment group what-if

Wykonaj operację wdrażania What-If w zakresie grupy zasobów.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--subscription]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Przykłady

Wykonaj operację wdrażania What-If w grupie zasobów.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Wykonaj operację wdrażania What-If w grupie zasobów w formacie ResourceIdOnly.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Wykonaj operację What-If w grupie zasobów bez ładnie drukowania wyniku.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parametry wymagane

--resource-group -g

Grupa zasobów do wykonania wdrożenia What-If operacji na stronie .

Parametry opcjonalne

--aux-tenants

Dzierżawy pomocnicze, które będą używane podczas wdrażania między dzierżawami.

--exclude-change-types -x

Rozdzielana spacjami lista typów zmian zasobów, które mają być wykluczone z What-If wyników.

akceptowane wartości: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Tryb wdrażania.

akceptowane wartości: Complete, Incremental
wartość domyślna: Incremental
--name -n

Nazwa wdrożenia.

--no-pretty-print

Wyłącz funkcję pretty-print dla What-If wyników. Po ustawioniu zostanie użyty typ formatu danych wyjściowych.

--no-prompt

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

akceptowane wartości: false, true
--parameters -p

Należy podać wartości parametrów wdrożenia.

--query-string -q

Ciąg zapytania (token SAS) do użycia z szablonem URI w przypadku połączonych szablonów.

--result-format -r

Format What-If danych.

akceptowane wartości: FullResourcePayloads, ResourceIdOnly
wartość domyślna: FullResourcePayloads
--subscription

Nazwa lub identyfikator subskrypcji. Domyślną subskrypcję można skonfigurować przy użyciu narzędzia az account set -s NAME_OR_ID .

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicpe.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

URI pliku szablonu.