Sdílet prostřednictvím

az vm extension

  • Reference

Správa rozšíření na virtuálních počítačích

Rozšíření jsou malé aplikace, které poskytují úlohy konfigurace a automatizace po nasazení na virtuálních počítačích Azure. Pokud například virtuální počítač vyžaduje instalaci softwaru, antivirovou ochranu nebo konfiguraci Dockeru, dá se k provedení těchto úloh použít rozšíření virtuálního počítače. Rozšíření je možné sbalit s nasazením nového virtuálního počítače nebo spustit v jakémkoli existujícím systému.

Příkazy

Name Description Typ Stav
az vm extension delete

Operace odstranění rozšíření.

 Základ GA
az vm extension image

Vyhledejte dostupná rozšíření virtuálních počítačů pro předplatné a oblast.

 Základ GA
az vm extension image list

Uveďte informace o dostupných rozšířeních.

 Základ GA
az vm extension image list-names

Zobrazí seznam názvů dostupných rozšíření.

 Základ GA
az vm extension image list-versions

Zobrazí seznam verzí dostupných rozšíření.

 Základ GA
az vm extension image show

Zobrazí informace o rozšíření.

 Základ GA
az vm extension list

Zobrazí seznam rozšíření připojených k virtuálnímu počítači.

 Základ GA
az vm extension set

Nastavte rozšíření pro virtuální počítač.

 Základ GA
az vm extension show

Zobrazí informace o rozšířeních připojených k virtuálnímu počítači.

 Základ GA
az vm extension wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka rozšíření virtuálního počítače.

 Základ GA

az vm extension delete

Upravit

Operace odstranění rozšíření.

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

Příklady

K odstranění rozšíření z virtuálního počítače použijte název a rozšíření virtuálního počítače.

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

Odstraňte rozšíření s ID obsahujícím řetězec MyExtension z virtuálního počítače.

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

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

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

Název rozšíření virtuálního počítače

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults vm=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm extension list

Upravit

Zobrazí seznam rozšíření připojených k virtuálnímu počítači.

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

Příklady

Zobrazí seznam připojených rozšíření k pojmenovaným virtuálním počítačům.

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

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults vm=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm extension set

Upravit

Nastavte rozšíření pro virtuální počítač.

Získejte podrobnosti o rozšíření z 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říklady

Přidejte uživatelský účet k virtuálnímu počítači s Linuxem.

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 ..."}'

Přidání rozšíření customScriptu do virtuálních počítačů určených parametrem --ids

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

Přidejte rozšíření a povolte automatický upgrade platformou, pokud je k dispozici novější verze rozšíření.

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

Povinné parametry

--name -n

Název rozšíření.

Počáteční hodnota: az vm extension image list
--publisher

Název vydavatele rozšíření.

Volitelné parametry

--enable-auto-upgrade

Pokud je k dispozici novější verze rozšíření, měla by se rozšíření automaticky upgradovat platformou.

Přípustné hodnoty: false, true
--extension-instance-name

Název instance rozšíření, kterou lze přizpůsobit. Výchozí hodnota: název rozšíření.

--force-update

Vynucení aktualizace i v případě, že se konfigurace rozšíření nezměnila.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--no-auto-upgrade
Zastaralé

Možnost --no-auto-upgrade je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte podverzi --no-auto-upgrade-minor-version.

Pokud je tato možnost nastavená, služba rozšíření nebude automaticky vybírat ani upgradovat na nejnovější podverzi, i když je rozšíření znovu nasazené.

Přípustné hodnoty: false, true
Default value: False
--no-auto-upgrade-minor-version

Pokud je tato možnost nastavená, služba rozšíření nebude automaticky vybírat ani upgradovat na nejnovější podverzi, i když je rozšíření znovu nasazené.

Přípustné hodnoty: false, true
Default value: False
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--protected-settings

Chráněná nastavení ve formátu JSON pro citlivé informace, jako jsou přihlašovací údaje. Akceptuje se také cesta k souboru JSON.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--settings

Nastavení rozšíření ve formátu JSON Akceptuje se také cesta k souboru JSON.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--version

Verze rozšíření. Pokud chcete připnout verzi rozšíření na tuto hodnotu, zadejte --no-auto-upgrade-minor-version.

--vm-name

Název virtuálního počítače. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults vm=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm extension show

Upravit

Zobrazí informace o rozšířeních připojených k virtuálnímu počítači.

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

Příklady

Pomocí názvu virtuálního počítače a názvu rozšíření zobrazte rozšíření připojená k virtuálnímu počítači.

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

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--instance-view

Zobrazení instance rozšíření virtuálního počítače.

Default value: False
--name -n

Název rozšíření.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults vm=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm extension wait

Upravit

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka rozšíření virtuálního počítače.

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

Příklady

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka rozšíření virtuálního počítače. (automaticky vygenerováno)

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

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka rozšíření virtuálního počítače. (automaticky vygenerováno)

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

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka rozšíření virtuálního počítače. (automaticky vygenerováno)

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

Volitelné parametry

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

Default value: False
--exists

Počkejte, až prostředek existuje.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--interval

Interval dotazování v sekundách

Default value: 30
--name -n

Název rozšíření.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--timeout

Maximální čekání v sekundách.

Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Default value: False
--vm-name

Název virtuálního počítače. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults vm=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.