az vm extension

  • Referentie

Extensies op VM's beheren.

Extensies zijn kleine toepassingen die configuratie- en automatiseringstaken na de implementatie bieden op virtuele Azure-machines. Als een virtuele machine bijvoorbeeld software-installatie, antivirusbeveiliging of Docker-configuratie vereist, kan een VM-extensie worden gebruikt om deze taken uit te voeren. Extensies kunnen worden gebundeld met een nieuwe implementatie van virtuele machines of worden uitgevoerd op elk bestaand systeem.

Opdracht

Name Description Type Status
az vm extension delete

Verwijderbewerking om de extensie te verwijderen.

 Basis GA
az vm extension image

Zoek de beschikbare VM-extensies voor een abonnement en regio.

 Basis GA
az vm extension image list

Geef de informatie weer over beschikbare extensies.

 Basis GA
az vm extension image list-names

Geef de namen van beschikbare extensies weer.

 Basis GA
az vm extension image list-versions

Geef de versies weer voor beschikbare extensies.

 Basis GA
az vm extension image show

Informatie weergeven voor een extensie.

 Basis GA
az vm extension list

Vermeld de extensies die zijn gekoppeld aan een virtuele machine.

 Basis GA
az vm extension set

Extensies instellen voor een virtuele machine.

 Basis GA
az vm extension show

Informatie weergeven over extensies die zijn gekoppeld aan een virtuele machine.

 Basis GA
az vm extension wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een virtuele-machine-extensie wordt voldaan.

 Basis GA

az vm extension delete

Bewerken

Verwijderbewerking om de extensie te verwijderen.

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

Voorbeelden

Gebruik een VM-naam en -extensie om een extensie van een VIRTUELE machine te verwijderen.

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

Verwijder extensies met id's die de tekenreeks 'MyExtension' van een VIRTUELE machine bevatten.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

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

De naam van de extensie van de virtuele machine.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--vm-name

De naam van de virtuele machine. U kunt de standaardinstelling configureren met behulp van az configure --defaults vm=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az vm extension list

Bewerken

Vermeld de extensies die zijn gekoppeld aan een virtuele machine.

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

Voorbeelden

Lijst met gekoppelde extensies voor een benoemde VM.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--vm-name

De naam van de virtuele machine. U kunt de standaardinstelling configureren met behulp van az configure --defaults vm=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az vm extension set

Bewerken

Extensies instellen voor een virtuele machine.

Extensiedetails ophalen van 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]

Voorbeelden

Voeg een gebruikersaccount toe aan een Virtuele Linux-machine.

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

Voeg een customScript-extensie toe aan VM('s) die zijn opgegeven door --id's.

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

Voeg een extensie toe en schakel automatische upgrade door het platform in als er een nieuwere versie van de extensie beschikbaar is.

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

Vereiste parameters

--name -n

Naam van de extensie.

waarde vanaf: az vm extension image list
--publisher

De naam van de uitgever van de extensie.

Optionele parameters

--enable-auto-upgrade

Geef aan dat de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.

geaccepteerde waarden: false, true
--extension-instance-name

De naam van het extensie-exemplaar, dat kan worden aangepast. Standaard: de naam van de extensie.

--force-update

Forceren om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.

standaardwaarde: False
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--no-auto-upgrade
Afgeschaft

Optie '---no-auto-upgrade' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '---no-auto-upgrade-minor-version'.

Als deze optie is ingesteld, wordt de extensieservice niet automatisch gekozen of bijgewerkt naar de nieuwste secundaire versie, zelfs als de extensie opnieuw wordt geïmplementeerd.

geaccepteerde waarden: false, true
standaardwaarde: False
--no-auto-upgrade-minor-version

Als deze optie is ingesteld, wordt de extensieservice niet automatisch gekozen of bijgewerkt naar de nieuwste secundaire versie, zelfs als de extensie opnieuw wordt geïmplementeerd.

geaccepteerde waarden: false, true
standaardwaarde: False
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--protected-settings

Beveiligde instellingen in JSON-indeling voor gevoelige informatie, zoals referenties. Er wordt ook een JSON-bestandspad geaccepteerd.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--settings

Extensie-instellingen in JSON-indeling. Er wordt ook een JSON-bestandspad geaccepteerd.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--version

De versie van de extensie. Als u de extensieversie aan deze waarde wilt vastmaken, geeft u --no-auto-upgrade-minor-version op.

--vm-name

De naam van de virtuele machine. U kunt de standaardinstelling configureren met behulp van az configure --defaults vm=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az vm extension show

Bewerken

Informatie weergeven over extensies die zijn gekoppeld aan een virtuele machine.

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

Voorbeelden

Gebruik de naam en de extensienaam van de VM om de extensies weer te geven die zijn gekoppeld aan een VIRTUELE machine.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--instance-view

De exemplaarweergave van een virtuele-machineextensie.

standaardwaarde: False
--name -n

Naam van de extensie.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--vm-name

De naam van de virtuele machine. U kunt de standaardinstelling configureren met behulp van az configure --defaults vm=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az vm extension wait

Bewerken

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een virtuele-machine-extensie wordt voldaan.

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

Voorbeelden

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een virtuele-machine-extensie wordt voldaan. (automatisch gegenereerd)

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

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een virtuele-machine-extensie wordt voldaan. (automatisch gegenereerd)

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

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van een virtuele-machine-extensie wordt voldaan. (automatisch gegenereerd)

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

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

standaardwaarde: False
--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

standaardwaarde: False
--exists

Wacht tot de resource bestaat.

standaardwaarde: False
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--interval

Polling-interval in seconden.

standaardwaarde: 30
--name -n

Naam van de extensie.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

standaardwaarde: False
--vm-name

De naam van de virtuele machine. U kunt de standaardinstelling configureren met behulp van az configure --defaults vm=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.