az vm extension

Bővítmények kezelése virtuális gépeken.

A bővítmények olyan kis alkalmazások, amelyek üzembe helyezés utáni konfigurációs és automatizálási feladatokat biztosítanak az Azure-beli virtuális gépeken. Ha például egy virtuális gép szoftvertelepítést, vírusvédelemmel vagy Docker-konfigurációt igényel, a feladatok elvégzéséhez virtuálisgép-bővítmény használható. A bővítmények csomagolhatók egy új virtuális gép üzembe helyezésével, vagy futtathatók bármely meglévő rendszeren.

Parancsok

Name	Description	Típus	Állapot
az vm extension delete	Törlési művelet a bővítmény törléséhez.	Alapvető	FE
az vm extension image	Keresse meg az előfizetéshez és régióhoz elérhető virtuálisgép-bővítményeket.	Alapvető	FE
az vm extension image list	Az elérhető bővítmények adatainak listázása.	Alapvető	FE
az vm extension image list-names	Az elérhető bővítmények nevének listázása.	Alapvető	FE
az vm extension image list-versions	Az elérhető bővítmények verzióinak listázása.	Alapvető	FE
az vm extension image show	Bővítmény adatainak megjelenítése.	Alapvető	FE
az vm extension list	A virtuális géphez csatolt bővítmények listázása.	Alapvető	FE
az vm extension set	Bővítmények beállítása virtuális géphez.	Alapvető	FE
az vm extension show	A virtuális géphez csatolt bővítményekkel kapcsolatos információk megjelenítése.	Alapvető	FE
az vm extension wait	Helyezze a parancssori felületet várakozási állapotba, amíg a virtuálisgép-bővítmény egy feltétele teljesül.	Alapvető	FE

az vm extension delete

Törlési művelet a bővítmény törléséhez.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Példák

A virtuális gép nevét és bővítményét használva törölhet egy bővítményt egy virtuális gépről.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n MyExtensionName

Törölje a "MyExtension" sztringet tartalmazó azonosítókkal rendelkező bővítményeket egy virtuális gépről.

az vm extension delete --ids $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--name --vm-extension-name -n

A virtuálisgép-bővítmény neve.

--no-wait

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

elfogadott értékek: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

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

--vm-name

A virtuális gép neve. Az alapértelmezett beállítást a következővel az configure --defaults vm=<name>konfigurálhatja: .

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 vm extension list

A virtuális géphez csatolt bővítmények listázása.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Példák

Egy névvel ellátott virtuális géphez csatolt bővítmények listázása.

az vm extension list -g MyResourceGroup --vm-name MyVm

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

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

--vm-name

A virtuális gép neve. Az alapértelmezett beállítást a következővel az configure --defaults vm=<name>konfigurálhatja: .

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 vm extension set

Bővítmények beállítása virtuális géphez.

Bővítmény részleteinek lekérése a fájlból az vm extension image list.

az vm extension set --name
                    --publisher
                    [--enable-auto-upgrade {false, true}]
                    [--extension-instance-name]
                    [--force-update]
                    [--ids]
                    [--no-auto-upgrade {false, true}]
                    [--no-auto-upgrade-minor-version {false, true}]
                    [--no-wait]
                    [--protected-settings]
                    [--resource-group]
                    [--settings]
                    [--subscription]
                    [--version]
                    [--vm-name]

Példák

Felhasználói fiók hozzáadása Linux rendszerű virtuális géphez.

az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
    --vm-name MyVm --resource-group MyResourceGroup \
    --protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'

Adjon hozzá egy customScript-bővítményt a --ids által megadott virtuális gépekhez.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Adjon hozzá egy bővítményt, és engedélyezze a platform automatikus frissítését, ha elérhető a bővítmény újabb verziója.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

Kötelező paraméterek

--name -n

A bővítmény neve.

érték forrása: az vm extension image list

--publisher

A bővítmény közzétevőjének neve.

Opcionális paraméterek

--enable-auto-upgrade

Jelezze, hogy a bővítményt automatikusan frissítenie kell a platformnak, ha elérhető a bővítmény újabb verziója.

elfogadott értékek: false, true

--extension-instance-name

A testre szabható bővítménypéldány neve. Alapértelmezett: a bővítmény neve.

--force-update

A frissítés kényszerítése akkor is, ha a bővítménykonfiguráció nem változott.

alapértelmezett érték: False

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--no-auto-upgrade

Elavult

Az "--no-auto-upgrade" lehetőség elavult, és egy későbbi kiadásban el lesz távolítva. Használja helyette az "--no-auto-upgrade-minor-version" parancsot.

Ha be van állítva, a bővítményszolgáltatás nem fogja automatikusan kiválasztani vagy frissíteni a legújabb alverziót, még akkor sem, ha a bővítmény újra üzembe van állítva.

elfogadott értékek: false, true

alapértelmezett érték: False

--no-auto-upgrade-minor-version

Ha be van állítva, a bővítményszolgáltatás nem fogja automatikusan kiválasztani vagy frissíteni a legújabb alverziót, még akkor sem, ha a bővítmény újra üzembe van állítva.

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

--protected-settings

Védett beállítások JSON formátumban bizalmas információkhoz, például hitelesítő adatokhoz. A JSON-fájl elérési útja is elfogadott.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--settings

Bővítménybeállítások JSON formátumban. A JSON-fájl elérési útja is elfogadott.

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

--version

A bővítmény verziója. Ha a bővítményverziót ehhez az értékhez szeretné rögzíteni, adja meg a --no-auto-upgrade-minor-version értéket.

--vm-name

A virtuális gép neve. Az alapértelmezett beállítást a következővel az configure --defaults vm=<name>konfigurálhatja: .

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 vm extension show

A virtuális géphez csatolt bővítményekkel kapcsolatos információk megjelenítése.

az vm extension show [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Példák

A virtuális gép nevével és bővítménynevével megjelenítheti a virtuális géphez csatolt bővítményeket.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

Opcionális paraméterek

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--instance-view

Egy virtuálisgép-bővítmény példánynézete.

alapértelmezett érték: False

--name -n

A bővítmény neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

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

--vm-name

A virtuális gép neve. Az alapértelmezett beállítást a következővel az configure --defaults vm=<name>konfigurálhatja: .

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 vm extension wait

Helyezze a parancssori felületet várakozási állapotba, amíg a virtuálisgép-bővítmény egy feltétele teljesül.

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

Példák

Helyezze a parancssori felületet várakozási állapotba, amíg a virtuálisgép-bővítmény egy feltétele teljesül. (automatikusan létrehozott)

az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Helyezze a parancssori felületet várakozási állapotba, amíg a virtuálisgép-bővítmény egy feltétele teljesül. (automatikusan létrehozott)

az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Helyezze a parancssori felületet várakozási állapotba, amíg a virtuálisgép-bővítmény egy feltétele teljesül. (automatikusan létrehozott)

az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm

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

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--interval

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

alapértelmezett érték: 30

--name -n

A bővítmény neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

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

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

--vm-name

A virtuális gép neve. Az alapértelmezett beállítást a következővel az configure --defaults vm=<name>konfigurálhatja: .

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.