az deployment mg

Zarządzanie Azure Resource Manager szablonu w grupie zarządzania.

Polecenia

az deployment mg cancel

Anulowanie wdrożenia w grupie zarządzania.

az deployment mg create

Rozpocznij wdrożenie w grupie zarządzania.

az deployment mg delete

Usuwanie wdrożenia w grupie zarządzania.

az deployment mg export

Eksportuj szablon używany do wdrożenia.

az deployment mg list

Lista wdrożeń w grupie zarządzania.

az deployment mg show

Wyświetlanie wdrożenia w grupie zarządzania.

az deployment mg validate

Sprawdź, czy szablon jest prawidłowy w grupie zarządzania.

az deployment mg wait

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

az deployment mg what-if

Wykonaj operację wdrażania What-If w zakresie grupy zarządzania.

az deployment mg cancel

Anulowanie wdrożenia w grupie zarządzania.

az deployment mg cancel --management-group-id
                        --name
                        [--subscription]

Przykłady

Anulowanie wdrożenia w grupie zarządzania.

az deployment mg cancel -m testmg -n deployment01

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

--name -n

Nazwa wdrożenia.

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

Rozpocznij wdrożenie w grupie zarządzania.

az deployment mg create --location
                        --management-group-id
                        [--confirm-with-what-if]
                        [--handle-extended-json-format]
                        [--name]
                        [--no-prompt {false, true}]
                        [--no-wait]
                        [--parameters]
                        [--proceed-if-no-change]
                        [--query-string]
                        [--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 zarządzania na podstawie zdalnego pliku szablonu przy użyciu parametrów z lokalnego pliku JSON.

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Utwórz wdrożenie w grupie zarządzania na podstawie szablonu lokalnego, używając pliku parametrów, pliku parametrów zdalnych i selektywnego zastępowania par klucz/wartość.

az deployment mg create --management-group-id testmg --name rollout01 --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.

--management-group-id -m

Identyfikator grupy zarządzania do utworzenia wdrożenia w programie .

Parametry opcjonalne

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

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

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

Usuwanie wdrożenia w grupie zarządzania.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]
                        [--subscription]

Przykłady

Usuwanie wdrożenia w grupie zarządzania.

az deployment mg delete -m testmg -n deployment01

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

--name -n

Nazwa wdrożenia.

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

Eksportuj szablon używany do wdrożenia.

az deployment mg export --management-group-id
                        --name
                        [--subscription]

Przykłady

Wyeksportuj szablon używany do wdrożenia w grupie zarządzania.

az deployment mg export --management-group-id testmg --name MyDeployment

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

--name -n

Nazwa wdrożenia.

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

Lista wdrożeń w grupie zarządzania.

az deployment mg list --management-group-id
                      [--filter]
                      [--query-examples]
                      [--subscription]

Przykłady

Lista wdrożeń w grupie zarządzania.

az deployment mg list -m testmg

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

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

Wyświetlanie wdrożenia w grupie zarządzania.

az deployment mg show --management-group-id
                      --name
                      [--query-examples]
                      [--subscription]

Przykłady

Wyświetlanie wdrożenia w grupie zarządzania.

az deployment mg show -m testmg -n deployment01

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

--name -n

Nazwa wdrożenia.

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

Sprawdź, czy szablon jest prawidłowy w grupie zarządzania.

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

Przykłady

Sprawdź, czy szablon jest prawidłowy w grupie zarządzania.

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

Sprawdź, czy szablon jest prawidłowy w grupie zarządzania. (wygenerowane automatycznie)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Parametry wymagane

--location -l

Lokalizacja do przechowywania metadanych wdrożenia.

--management-group-id -m

Identyfikator grupy zarządzania 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.

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

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

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

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

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

--name -n

Nazwa wdrożenia.

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 mg what-if

Wykonaj operację wdrażania What-If w zakresie grupy zarządzania.

az deployment mg what-if --location
                         --management-group-id
                         [--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}]
                         [--subscription]
                         [--template-file]
                         [--template-spec]
                         [--template-uri]

Przykłady

Wykonaj operację wdrażania What-If w grupie zarządzania.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Wykonaj operację wdrażania What-If w grupie zarządzania w formacie ResourceIdOnly.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Wykonaj operację What-If w grupie zarządzania bez ładnie drukowania wyniku.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parametry wymagane

--location -l

Lokalizacja do przechowywania metadanych wdrożenia.

--management-group-id -m

Identyfikator grupy zarządzania do utworzenia wdrożenia w programie .

Parametry opcjonalne

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

--template-spec -s

Identyfikator zasobu specyfikacji szablonu.

--template-uri -u

URI pliku szablonu.