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.	Core	GA
az vm extension image	Zoek de beschikbare VM-extensies voor een abonnement en regio.	Core	GA
az vm extension image list	Geef de informatie weer over beschikbare extensies.	Core	GA
az vm extension image list-names	Geef de namen van beschikbare extensies weer.	Core	GA
az vm extension image list-versions	Geef de versies weer voor beschikbare extensies.	Core	GA
az vm extension image show	Informatie weergeven voor een extensie.	Core	GA
az vm extension list	Vermeld de extensies die zijn gekoppeld aan een virtuele machine.	Core	GA
az vm extension set	Extensies instellen voor een virtuele machine.	Core	GA
az vm extension show	Informatie weergeven over extensies die zijn gekoppeld aan een virtuele machine.	Core	GA
az vm extension wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.	Core	GA

az vm extension delete

Bewerken

Verwijderbewerking om de extensie te verwijderen.

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]

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

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

De naam van de extensie van de virtuele machine.

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--subscription

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--vm-name

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Eigenschap	Waarde
Default value:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--resource-group -g

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--subscription

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--vm-name

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Eigenschap	Waarde
Default value:	False

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.

Eigenschap	Waarde
Waarde vanaf:	az vm extension image list

--publisher

De naam van de uitgever van de extensie.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

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

Eigenschap	Waarde
Default value:	False

--ids

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

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

Eigenschap	Waarde
Default value:	False
Geaccepteerde waarden:	false, true

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

Eigenschap	Waarde
Default value:	False
Geaccepteerde waarden:	false, true

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
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

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--settings

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

--subscription

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Eigenschap	Waarde
Default value:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--instance-view

De exemplaarweergave van een virtuele-machineextensie.

Eigenschap	Waarde
Default value:	False

--name -n

Naam van de extensie.

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--resource-group -g

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--subscription

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--vm-name

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Eigenschap	Waarde
Default value:	False

az vm extension wait

Bewerken

Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.

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

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

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

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments

--deleted

Wacht totdat deze is verwijderd.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wacht tot de resource bestaat.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--expand

De uitvouwexpressie die moet worden toegepast op de bewerking.

--ids

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--interval

Polling-interval in seconden.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	30

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

De naam van de extensie van de virtuele machine.

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--resource-group -g

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--subscription

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

--timeout

Maximale wachttijd in seconden.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

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

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--vm-name

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

Eigenschap	Waarde
Parameter group:	Resource Id Arguments

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Eigenschap	Waarde
Default value:	False

Delen via

az vm extension

Opdracht

az vm extension delete

Voorbeelden

Optionele parameters

az vm extension list

Voorbeelden

Optionele parameters

az vm extension set

Voorbeelden

Vereiste parameters

Optionele parameters

az vm extension show

Voorbeelden

Optionele parameters

az vm extension wait

Optionele parameters

Feedback