Dela via

az vm extension

  • Referens

Hantera tillägg på virtuella datorer.

Tillägg är små program som tillhandahåller konfigurations- och automatiseringsuppgifter efter distributionen på virtuella Azure-datorer. Om en virtuell dator till exempel kräver programvaruinstallation, antivirusskydd eller Docker-konfiguration kan ett VM-tillägg användas för att slutföra dessa uppgifter. Tillägg kan paketeras med en ny distribution av virtuella datorer eller köras mot ett befintligt system.

Kommandon

Name Description Typ Status
az vm extension delete

Ta bort åtgärden för att ta bort tillägget.

 Kärna Allmän tillgänglighet
az vm extension image

Hitta de tillgängliga VM-tilläggen för en prenumeration och region.

 Kärna Allmän tillgänglighet
az vm extension image list

Visa en lista med information om tillgängliga tillägg.

 Kärna Allmän tillgänglighet
az vm extension image list-names

Lista namnen på tillgängliga tillägg.

 Kärna Allmän tillgänglighet
az vm extension image list-versions

Visa en lista över versioner för tillgängliga tillägg.

 Kärna Allmän tillgänglighet
az vm extension image show

Visa information för ett tillägg.

 Kärna Allmän tillgänglighet
az vm extension list

Visa en lista över tillägg som är kopplade till en virtuell dator.

 Kärna Allmän tillgänglighet
az vm extension set

Ange tillägg för en virtuell dator.

 Kärna Allmän tillgänglighet
az vm extension show

Visa information om tillägg som är kopplade till en virtuell dator.

 Kärna Allmän tillgänglighet
az vm extension wait

Placera CLI i vänteläge tills ett villkor för ett tillägg för en virtuell dator uppfylls.

 Kärna Allmän tillgänglighet

az vm extension delete

Redigera

Ta bort åtgärden för att ta bort tillägget.

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

Exempel

Använd ett namn och tillägg för den virtuella datorn för att ta bort ett tillägg från en virtuell dator.

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

Ta bort tillägg med ID:n som innehåller strängen "MyExtension" från en virtuell dator.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

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

Namnet på tillägget för den virtuella datorn.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--vm-name

Namnet på den virtuella datorn. Du kan konfigurera standardinställningen med .az configure --defaults vm=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vm extension list

Redigera

Visa en lista över tillägg som är kopplade till en virtuell dator.

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

Exempel

Lista bifogade tillägg till en namngiven virtuell dator.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--vm-name

Namnet på den virtuella datorn. Du kan konfigurera standardinställningen med .az configure --defaults vm=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vm extension set

Redigera

Ange tillägg för en virtuell dator.

Hämta tilläggsinformation från 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]

Exempel

Lägg till ett användarkonto på en virtuell Linux-dator.

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

Lägg till ett customScript-tillägg till virtuella datorer som anges av --id:n.

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

Lägg till ett tillägg och aktivera automatisk uppgradering av plattformen om det finns en nyare version av tillägget tillgängligt.

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

Obligatoriska parametrar

--name -n

Namnet på tillägget.

Värde från: az vm extension image list
--publisher

Namnet på tilläggsutgivaren.

Valfria parametrar

--enable-auto-upgrade

Ange att tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version av tillägget tillgängligt.

Godkända värden: false, true
--extension-instance-name

Namnet på tilläggsinstansen, som kan anpassas. Standard: namnet på tillägget.

--force-update

Framtvinga uppdatering även om tilläggskonfigurationen inte har ändrats.

Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--no-auto-upgrade
Inaktuell

Alternativet "--no-auto-upgrade" har blivit inaktuellt och tas bort i en framtida version. Använd "--no-auto-upgrade-minor-version" i stället.

Om det anges väljer eller uppgraderar inte tilläggstjänsten automatiskt till den senaste delversionen, även om tillägget distribueras om.

Godkända värden: false, true
Standardvärde: False
--no-auto-upgrade-minor-version

Om det anges väljer eller uppgraderar inte tilläggstjänsten automatiskt till den senaste delversionen, även om tillägget distribueras om.

Godkända värden: false, true
Standardvärde: False
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--protected-settings

Skyddade inställningar i JSON-format för känslig information som autentiseringsuppgifter. En JSON-filsökväg accepteras också.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--settings

Tilläggsinställningar i JSON-format. En JSON-filsökväg accepteras också.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--version

Versionen av tillägget. Om du vill fästa tilläggsversionen på det här värdet anger du --no-auto-upgrade-minor-version.

--vm-name

Namnet på den virtuella datorn. Du kan konfigurera standardinställningen med .az configure --defaults vm=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vm extension show

Redigera

Visa information om tillägg som är kopplade till en virtuell dator.

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

Exempel

Använd namnet på den virtuella datorn och tilläggsnamnet för att visa tilläggen som är kopplade till en virtuell dator.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--instance-view

Instansvyn för ett tillägg för virtuella datorer.

Standardvärde: False
--name -n

Namnet på tillägget.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--vm-name

Namnet på den virtuella datorn. Du kan konfigurera standardinställningen med .az configure --defaults vm=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vm extension wait

Redigera

Placera CLI i vänteläge tills ett villkor för ett tillägg för en virtuell dator uppfylls.

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

Exempel

Placera CLI i vänteläge tills ett villkor för ett tillägg för en virtuell dator uppfylls. (automatiskt genererad)

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

Placera CLI i vänteläge tills ett villkor för ett tillägg för en virtuell dator uppfylls. (automatiskt genererad)

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

Placera CLI i vänteläge tills ett villkor för ett tillägg för en virtuell dator uppfylls. (automatiskt genererad)

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

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

Standardvärde: False
--exists

Vänta tills resursen finns.

Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--interval

Avsökningsintervall i sekunder.

Standardvärde: 30
--name -n

Namnet på tillägget.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--timeout

Maximal väntetid i sekunder.

Standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Standardvärde: False
--vm-name

Namnet på den virtuella datorn. Du kan konfigurera standardinställningen med .az configure --defaults vm=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.