az deployment mg

  • Odwołanie

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

Polecenia

Nazwa Opis Typ Stan
az deployment mg cancel

Anuluj wdrożenie w grupie zarządzania.

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

Rozpocznij wdrożenie w grupie zarządzania.

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

Usuń wdrożenie w grupie zarządzania.

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

Wyeksportuj szablon używany do wdrożenia.

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

Wyświetlanie listy wdrożeń w grupie zarządzania.

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

Pokaż wdrożenie w grupie zarządzania.

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

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

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

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

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

Wykonaj operację analizy co-jeżeli wdrożenia w zakresie grupy zarządzania.

 Podstawowe funkcje Ogólna dostępność

az deployment mg cancel

Edytuj

Anuluj wdrożenie w grupie zarządzania.

az deployment mg cancel --management-group-id
                        --name

Przykłady

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

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg create

Edytuj

Rozpocznij wdrożenie w grupie zarządzania.

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

az deployment mg create --location
                        --management-group-id
                        [--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]
                        [--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 pliku szablonu zdalnego 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 pliku szablonu lokalnego 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 przy użyciu pliku parametrów, pliku parametrów zdalnych i selektywnie przesłaniania 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.

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.

--mode

Tryb używany do wdrażania zasobów. Ta wartość może być przyrostowa lub ukończona. W trybie przyrostowym zasoby są wdrażane bez usuwania istniejących zasobów, które nie są uwzględnione w szablonie. W trybie kompletnym zasoby są wdrażane, a istniejące zasoby w grupie zasobów, które nie są uwzględnione w szablonie, są usuwane. Należy zachować ostrożność podczas korzystania z trybu ukończenia, ponieważ możesz przypadkowo usunąć zasoby.

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. 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
wartość domyślna: False
--no-wait

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

wartość domyślna: 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.

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

akceptowane wartości: FullResourcePayloads, ResourceIdOnly
wartość domyślna: 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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg delete

Edytuj

Usuń wdrożenie w grupie zarządzania.

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

Przykłady

Usuń wdrożenie 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.

wartość domyślna: 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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg export

Edytuj

Wyeksportuj szablon używany do wdrożenia.

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

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

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg list

Edytuj

Wyświetlanie listy wdrożeń w grupie zarządzania.

az deployment mg list --management-group-id
                      [--filter]

Przykłady

Wyświetlanie listy 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
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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg show

Edytuj

Pokaż wdrożenie w grupie zarządzania.

az deployment mg show --management-group-id
                      --name

Przykłady

Pokaż wdrożenie 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 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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg validate

Edytuj

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

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

az deployment mg validate --location
                          --management-group-id
                          [--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 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. (automatycznie wygenerowane)

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.

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.

akceptowane wartości: false, true
wartość domyślna: 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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg wait

Edytuj

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

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

Parametry wymagane

--management-group-id -m

Identyfikator grupy zarządzania.

--name -n

Nazwa wdrożenia.

Parametry opcjonalne

--created

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

wartość domyślna: False
--custom

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

--deleted

Poczekaj na usunięcie.

wartość domyślna: False
--exists

Zaczekaj, aż zasób istnieje.

wartość domyślna: False
--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

wartość domyślna: 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.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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 mg what-if

Edytuj

Wykonaj operację analizy co-jeżeli wdrożenia w zakresie grupy zarządzania.

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

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

Przykłady

Wykonaj operację analizy co-jeżeli wdrożenia 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ę analizy co-jeżeli wdrożenia w grupie zarządzania przy użyciu formatu 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ę analizy co-jeżeli wdrożenia w grupie zarządzania bez konieczności 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.

Parametry opcjonalne

--exclude-change-types -x

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

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

akceptowane wartości: false, true
wartość domyślna: 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.

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

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: 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.