az deployment group

  • Odwołanie

Zarządzanie wdrożeniem szablonu usługi Azure Resource Manager w grupie zasobów.

Polecenia

az deployment group cancel

Anuluj wdrożenie 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

Wyświetlanie listy wdrożeń w grupie zasobów.
az deployment group show

Pokaż wdrożenie 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 do momentu spełnienia warunku wdrożenia.
az deployment group what-if

Wykonaj operację What-If wdrożenia w zakresie grupy zasobów.

az deployment group cancel

Edytuj

Anuluj wdrożenie w grupie zasobów.

az deployment group cancel --name
                           --resource-group

Przykłady

Anuluj wdrożenie 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 polecenia az configure --defaults group=<name>.

az deployment group create

Edytuj

Rozpocznij wdrożenie w grupie zasobów.

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

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]
                           [--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 pliku szablonu zdalnego 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 pliku szablonu lokalnego 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 pliku szablonu lokalnego 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 przy użyciu pliku parametrów, pliku parametrów zdalnych i selektywnie zastępowania par 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 grupy zasobów 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.

Parametry opcjonalne

--aux-subs

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

--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 uruchomić wdrożenie What-If przed wykonaniem wdrożenia. Następnie monituje o potwierdzenie zmian zasobów przed kontynuowaniem.

--handle-extended-json-format -j

Obsługa obsługi rozszerzonej zawartości szablonu, w tym wielowierszowych 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 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.

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

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

--parameters -p

Podaj wartości parametrów wdrożenia.

--proceed-if-no-change

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

--query-string -q

Ciąg zapytania (token sygnatury dostępu współdzielonego) do użycia z identyfikatorem URI szablonu w przypadku połączonych szablonów.

--rollback-on-error

Nazwa wdrożenia, aby przywrócić błąd lub użyć jako flagi, aby przywrócić ostatnie pomyślne wdrożenie.

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

Identyfikator URI 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 What-If wyników. Dotyczy ustawienia --confirm-with-what-if.

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

Format What-If wyników. --confirm-with-what-if Dotyczy ustawienia.

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

az deployment group delete

Edytuj

Usuń wdrożenie w grupie zasobów.

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

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 polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--no-wait

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

az deployment group export

Edytuj

Eksportuj szablon używany do wdrożenia.

az deployment group export --name
                           --resource-group

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 polecenia az configure --defaults group=<name>.

az deployment group list

Edytuj

Wyświetlanie listy wdrożeń w grupie zasobów.

az deployment group list --resource-group
                         [--filter]

Przykłady

Wyświetlanie listy 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 polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--filter

Wyrażenie filtru 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/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

az deployment group show

Edytuj

Pokaż wdrożenie w grupie zasobów.

az deployment group show --name
                         --resource-group

Przykłady

Pokaż wdrożenie 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 polecenia az configure --defaults group=<name>.

az deployment group validate

Edytuj

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

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

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--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. (generowane 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.

Parametry opcjonalne

--handle-extended-json-format -j

Obsługa obsługi rozszerzonej zawartości szablonu, w tym wielowierszowych 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 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.

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

Podaj wartości parametrów wdrożenia.

--query-string -q

Ciąg zapytania (token sygnatury dostępu współdzielonego) do użycia z identyfikatorem URI szablonu w przypadku połączonych szablonów.

--rollback-on-error

Nazwa wdrożenia, aby przywrócić błąd lub użyć jako flagi, aby przywrócić ostatnie pomyślne wdrożenie.

--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

Identyfikator URI pliku szablonu.

az deployment group wait

Edytuj

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

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

Przykłady

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku wdrożenia. (generowane 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 polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" w lokalizacji "Powodzenie".

--custom

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

--deleted

Zaczekaj na usunięcie.

--exists

Zaczekaj, aż zasób istnieje.

--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na aktualizację za pomocą parametru provisioningState w lokalizacji "Powodzenie".

az deployment group what-if

Edytuj

Wykonaj operację What-If wdrożenia w zakresie grupy zasobów.

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

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}]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Przykłady

Wykonaj operację What-If wdrożenia 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 z formatem 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ę wdrażania What-If w grupie zasobów bez dość 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 operacji wdrażania What-If pod adresem.

Parametry opcjonalne

--aux-tenants

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

--exclude-change-types -x

Rozdzielona spacjami lista typów zmian zasobów, które mają zostać 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 ładne drukowanie dla wyników What-If. Po ustawieniu zostanie użyty typ formatu danych wyjściowych.

--no-prompt

Opcja wyłączenia monitu o brakujące parametry 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.

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

Podaj wartości parametrów wdrożenia.

--query-string -q

Ciąg zapytania (token sygnatury dostępu współdzielonego) do użycia z identyfikatorem URI szablonu w przypadku połączonych szablonów.

--result-format -r

Format What-If wyników.

akceptowane wartości: FullResourcePayloads, ResourceIdOnly
wartość domyślna: FullResourcePayloads
--template-file -f

Ścieżka do pliku szablonu lub pliku Bicep.

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

Identyfikator URI pliku szablonu.