az vm extension

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

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

Default value: 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

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

Default value: 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

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.

Default value: 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

Default value: 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

Default value: False

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: 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

Default value: 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

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.

Default value: 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

Default value: 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

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

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

Default value: False

--exists

Wacht tot de resource bestaat.

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

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

Default value: 3600

--updated

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

Default value: 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

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