az vm extension

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í.	Core	GA
az vm extension image	Vyhledejte dostupná rozšíření virtuálních počítačů pro předplatné a oblast.	Core	GA
az vm extension image list	Uveďte informace o dostupných rozšířeních.	Core	GA
az vm extension image list-names	Zobrazí seznam názvů dostupných rozšíření.	Core	GA
az vm extension image list-versions	Zobrazí seznam verzí dostupných rozšíření.	Core	GA
az vm extension image show	Zobrazí informace o rozšíření.	Core	GA
az vm extension list	Zobrazí seznam rozšíření připojených k virtuálnímu počítači.	Core	GA
az vm extension set	Nastavte rozšíření pro virtuální počítač.	Core	GA
az vm extension show	Zobrazí informace o rozšířeních připojených k virtuálnímu počítači.	Core	GA
az vm extension wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.	Core	GA

az vm extension delete

Upravit

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

az vm extension delete [--ids]
                       [--name --vm-extension-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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

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

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--no-wait

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

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--vm-name

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--vm-name

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

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

Vlastnost	Hodnota
Počáteční hodnota:	az vm extension image list

--publisher

Název vydavatele rozšíření.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--enable-auto-upgrade

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

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

Vlastnost	Hodnota
Default value:	False

--ids

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

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

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

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

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

--no-wait

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

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--instance-view

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

Vlastnost	Hodnota
Default value:	False

--name -n

Název rozšíření.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--vm-name

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az vm extension wait

Upravit

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--created

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--custom

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments

--deleted

Počkejte na odstranění.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--exists

Počkejte, až prostředek existuje.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--expand

Výraz rozbalení, který se má použít pro operaci.

--ids

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--interval

Interval dotazování v sekundách

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	30

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

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--timeout

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	3600

--updated

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
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>.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

az vm extension

Příkazy

az vm extension delete

Příklady

Volitelné parametry

az vm extension list

Příklady

Volitelné parametry

az vm extension set

Příklady

Povinné parametry

Volitelné parametry

az vm extension show

Příklady

Volitelné parametry

az vm extension wait

Volitelné parametry

Váš názor