az deployment mg

  • Referencia

Azure Resource Manager-sablon üzembe helyezésének kezelése a felügyeleti csoportban.

Parancsok

Name Description Típus Állapot
az deployment mg cancel

Az üzembe helyezés megszakítása a felügyeleti csoportban.

 Alapvető FE
az deployment mg create

Üzembe helyezés indítása a felügyeleti csoportban.

 Alapvető FE
az deployment mg delete

Központi telepítés törlése a felügyeleti csoportban.

 Alapvető FE
az deployment mg export

Exportálja az üzembe helyezéshez használt sablont.

 Alapvető FE
az deployment mg list

Központi telepítések listázása a felügyeleti csoportban.

 Alapvető FE
az deployment mg show

Üzembe helyezés megjelenítése a felügyeleti csoportban.

 Alapvető FE
az deployment mg validate

Ellenőrizze, hogy egy sablon érvényes-e a felügyeleti csoportban.

 Alapvető FE
az deployment mg wait

Helyezze a parancssori felületet várakozási állapotba, amíg egy üzembe helyezési feltétel nem teljesül.

 Alapvető FE
az deployment mg what-if

Futtass egy üzembe helyezési lehetőség műveletet a felügyeleti csoport hatókörében.

 Alapvető FE

az deployment mg cancel

Szerkesztés

Az üzembe helyezés megszakítása a felügyeleti csoportban.

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

Példák

Az üzembe helyezés megszakítása a felügyeleti csoportban.

az deployment mg cancel -m testmg -n deployment01

Kötelező paraméterek

--management-group-id -m

A felügyeleti csoport azonosítója.

--name -n

Az üzembe helyezés neve.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg create

Szerkesztés

Üzembe helyezés indítása a felügyeleti csoportban.

Adjon meg csak egy --template-file FILE | --template-uri URI | --template-spec az ARM-sablon beviteléhez.

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

Példák

Hozzon létre egy központi telepítést a felügyeleti csoportban egy távoli sablonfájlból egy helyi JSON-fájl paramétereinek használatával.

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

Hozzon létre egy üzembe helyezést a felügyeleti csoportban egy helyi sablonfájlból egy JSON-sztring paramétereinek használatával.

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

Hozzon létre egy üzembe helyezést a felügyeleti csoportban egy helyi sablonból paraméterfájl, távoli paraméterfájl és szelektíven felülíró kulcs-érték párok használatával.

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

Kötelező paraméterek

--location -l

Az üzembehelyezési metaadatok tárolásának helye.

--management-group-id -m

A felügyeleti csoport azonosítója, amellyel üzembe helyezést hozhat létre.

Opcionális paraméterek

--confirm-with-what-if -c

Utasítsa a parancsot, hogy az üzembe helyezés végrehajtása előtt futtassa a "What-If" parancsot. Ezután a művelet arra kéri, hogy a folytatás előtt nyugtázza az erőforrás-módosításokat.

--handle-extended-json-format -j
Elavult

A "-handle-extended-json-format/-j" lehetőség elavult, és egy későbbi kiadásban el lesz távolítva.

Támogatja a kiterjesztett sablontartalmak kezelését, beleértve a többsoros és a megjegyzéseket az üzembe helyezés során.

--mode

Az erőforrások üzembe helyezéséhez használt mód. Ez az érték növekményes vagy befejezett lehet. Növekményes módban az erőforrások a sablonban nem szereplő meglévő erőforrások törlése nélkül lesznek üzembe helyezve. Teljes módban az erőforrások üzembe lesznek helyezve, és a sablonban nem szereplő erőforráscsoport meglévő erőforrásai törlődnek. Legyen óvatos a Teljes mód használatakor, mert előfordulhat, hogy véletlenül törli az erőforrásokat.

elfogadott értékek: Complete, Incremental
alapértelmezett érték: Incremental
--name -n

Az üzembe helyezés neve.

--no-prompt

Lehetőség az ARM-sablon hiányzó paramétereinek letiltására. Ha az érték igaz, a rendszer figyelmen kívül hagyja azt a kérést, amely szerint a felhasználók hiányzó paramétert kell megadniuk. Az alapértelmezett érték: hamis.

elfogadott értékek: false, true
alapértelmezett érték: False
--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

alapértelmezett érték: False
--parameters -p

Adja meg az üzembehelyezési paraméter értékeit.

A paraméterek a szintaxis, a JSON-sztring vagy a @{path} KEY=VALUE> párok <használatával adhatóak meg egy fájlból. A paraméterek kiértékelése sorrendben történik, így ha egy érték kétszer van hozzárendelve, az utóbbi érték lesz használva. Javasoljuk, hogy először adja meg a paraméterfájlt, majd bírálja felül szelektíven a KEY=VALUE szintaxissal.

--proceed-if-no-change

Utasítsa a parancsot az üzembe helyezés végrehajtására, ha a What-If eredmény nem tartalmaz erőforrás-módosításokat. Akkor alkalmazható, ha be van állítva a --confirm-with-what-if.

--query-string -q

Csatolt sablonok esetén a sablon-uri-hoz használandó lekérdezési sztring (SAS-jogkivonat).

--template-file -f

A sablonfájl vagy a Bicep-fájl elérési útja.

--template-spec -s

A sablon specifikációjának erőforrás-azonosítója.

--template-uri -u

A sablonfájl URI-ja.

--what-if -w

Utasítsa a parancsot az üzembe helyezési lehetőség futtatására.

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

A lehetőség szerinti eredményekből kizárandó erőforrás-változástípusok szóközzel elválasztott listája. Akkor alkalmazható, ha be van állítva a --confirm-with-what-if.

elfogadott értékek: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

A What-If eredmények formátuma. Ha be van állítva, akkor --confirm-with-what-if alkalmazható.

elfogadott értékek: FullResourcePayloads, ResourceIdOnly
alapértelmezett érték: FullResourcePayloads
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg delete

Szerkesztés

Központi telepítés törlése a felügyeleti csoportban.

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

Példák

Központi telepítés törlése a felügyeleti csoportban.

az deployment mg delete -m testmg -n deployment01

Kötelező paraméterek

--management-group-id -m

A felügyeleti csoport azonosítója.

--name -n

Az üzembe helyezés neve.

Opcionális paraméterek

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg export

Szerkesztés

Exportálja az üzembe helyezéshez használt sablont.

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

Példák

Exportálja az üzembe helyezéshez használt sablont a felügyeleti csoportban.

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

Kötelező paraméterek

--management-group-id -m

A felügyeleti csoport azonosítója.

--name -n

Az üzembe helyezés neve.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg list

Szerkesztés

Központi telepítések listázása a felügyeleti csoportban.

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

Példák

Központi telepítések listázása a felügyeleti csoportban.

az deployment mg list -m testmg

Kötelező paraméterek

--management-group-id -m

A felügyeleti csoport azonosítója.

Opcionális paraméterek

--filter
Előnézet

Kifejezés szűrése OData-jelöléssel. A provisioningState szűréséhez használhatja a "provisioningState eq "{state}" szűrőt. További információkért látogasson el https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameterside.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg show

Szerkesztés

Üzembe helyezés megjelenítése a felügyeleti csoportban.

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

Példák

Üzembe helyezés megjelenítése a felügyeleti csoportban.

az deployment mg show -m testmg -n deployment01

Kötelező paraméterek

--management-group-id -m

A felügyeleti csoport azonosítója.

--name -n

Az üzembe helyezés neve.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg validate

Szerkesztés

Ellenőrizze, hogy egy sablon érvényes-e a felügyeleti csoportban.

Adjon meg csak egy --template-file FILE | --template-uri URI | --template-spec az ARM-sablon beviteléhez.

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]

Példák

Ellenőrizze, hogy egy sablon érvényes-e a felügyeleti csoportban.

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

Ellenőrizze, hogy egy sablon érvényes-e a felügyeleti csoportban. (automatikusan létrehozott)

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

Kötelező paraméterek

--location -l

Az üzembehelyezési metaadatok tárolásának helye.

--management-group-id -m

A felügyeleti csoport azonosítója, amellyel üzembe helyezést hozhat létre.

Opcionális paraméterek

--handle-extended-json-format -j
Elavult

A "-handle-extended-json-format/-j" lehetőség elavult, és egy későbbi kiadásban el lesz távolítva.

Támogatja a kiterjesztett sablontartalmak kezelését, beleértve a többsoros és a megjegyzéseket az üzembe helyezés során.

--name -n

Az üzembe helyezés neve.

--no-prompt

Lehetőség az ARM-sablon hiányzó paramétereinek letiltására. Ha az érték igaz, a rendszer figyelmen kívül hagyja azt a kérést, amely szerint a felhasználók hiányzó paramétert kell megadniuk. Az alapértelmezett érték: hamis.

elfogadott értékek: false, true
alapértelmezett érték: False
--parameters -p

Adja meg az üzembehelyezési paraméter értékeit.

A paraméterek a szintaxis, a JSON-sztring vagy a @{path} KEY=VALUE> párok <használatával adhatóak meg egy fájlból. A paraméterek kiértékelése sorrendben történik, így ha egy érték kétszer van hozzárendelve, az utóbbi érték lesz használva. Javasoljuk, hogy először adja meg a paraméterfájlt, majd bírálja felül szelektíven a KEY=VALUE szintaxissal.

--query-string -q

Csatolt sablonok esetén a sablon-uri-hoz használandó lekérdezési sztring (SAS-jogkivonat).

--template-file -f

A sablonfájl vagy a Bicep-fájl elérési útja.

--template-spec -s

A sablon specifikációjának erőforrás-azonosítója.

--template-uri -u

A sablonfájl URI-ja.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg wait

Szerkesztés

Helyezze a parancssori felületet várakozási állapotba, amíg egy üzembe helyezési feltétel nem teljesül.

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

Kötelező paraméterek

--management-group-id -m

A felügyeleti csoport azonosítója.

--name -n

Az üzembe helyezés neve.

Opcionális paraméterek

--created

Várjon, amíg létre nem jön a "provisioningState" a "Sikeres" helyen.

alapértelmezett érték: False
--custom

Várjon, amíg a feltétel megfelel egy egyéni JMESPath-lekérdezésnek. Pl. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running"?.

--deleted

Várjon a törlésig.

alapértelmezett érték: False
--exists

Várjon, amíg az erőforrás létezik.

alapértelmezett érték: False
--interval

Lekérdezési időköz másodpercben.

alapértelmezett érték: 30
--timeout

Maximális várakozás másodpercben.

alapértelmezett érték: 3600
--updated

Várjon, amíg frissül a provisioningState a következő helyen: "Sikeres".

alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az deployment mg what-if

Szerkesztés

Futtass egy üzembe helyezési lehetőség műveletet a felügyeleti csoport hatókörében.

Adjon meg csak egy --template-file FILE | --template-uri URI | --template-spec az ARM-sablon beviteléhez.

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]

Példák

Futtass egy üzembe helyezési lehetőség műveletet egy felügyeleti csoportban.

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

Futtassunk ki egy üzembe helyezési lehetőség műveletet egy ResourceIdOnly formátumú felügyeleti csoportban.

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

Az üzembe helyezési lehetőség művelet végrehajtása felügyeleti csoportban az eredmény szép nyomtatása nélkül.

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

Kötelező paraméterek

--location -l

Az üzembehelyezési metaadatok tárolásának helye.

--management-group-id -m

A felügyeleti csoport azonosítója, amellyel üzembe helyezést hozhat létre.

Opcionális paraméterek

--exclude-change-types -x

A lehetőség szerinti eredményekből kizárandó erőforrás-változástípusok szóközzel elválasztott listája.

elfogadott értékek: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Az üzembe helyezés neve.

--no-pretty-print

Tiltsa le a szép nyomtatást a "What-If" eredményekhez. Ha be van állítva, a kimeneti formátum típusa lesz használva.

--no-prompt

Lehetőség az ARM-sablon hiányzó paramétereinek letiltására. Ha az érték igaz, a rendszer figyelmen kívül hagyja azt a kérést, amely szerint a felhasználók hiányzó paramétert kell megadniuk. Az alapértelmezett érték: hamis.

elfogadott értékek: false, true
alapértelmezett érték: False
--parameters -p

Adja meg az üzembehelyezési paraméter értékeit.

A paraméterek a szintaxis, a JSON-sztring vagy a @{path} KEY=VALUE> párok <használatával adhatóak meg egy fájlból. A paraméterek kiértékelése sorrendben történik, így ha egy érték kétszer van hozzárendelve, az utóbbi érték lesz használva. Javasoljuk, hogy először adja meg a paraméterfájlt, majd bírálja felül szelektíven a KEY=VALUE szintaxissal.

--query-string -q

Csatolt sablonok esetén a sablon-uri-hoz használandó lekérdezési sztring (SAS-jogkivonat).

--result-format -r

A What-If eredmények formátuma.

elfogadott értékek: FullResourcePayloads, ResourceIdOnly
alapértelmezett érték: FullResourcePayloads
--template-file -f

A sablonfájl vagy a Bicep-fájl elérési útja.

--template-spec -s

A sablon specifikációjának erőforrás-azonosítója.

--template-uri -u

A sablonfájl URI-ja.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.