az vm extension

Extensies op VM's beheren.

Extensies zijn kleine toepassingen die configuratie na de implementatie en automatiseringstaken op virtuele Azure-machines bieden. Als voor een virtuele machine bijvoorbeeld software-installatie, antivirusbeveiliging of Docker-configuratie is 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

az vm extension delete

Verwijder een extensie die is gekoppeld aan een VM.

az vm extension image

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

az vm extension image list

Vermeld de informatie over beschikbare extensies.

az vm extension image list-names

Vermeld de namen van de beschikbare extensies.

az vm extension image list-versions

Vermeld de versies voor beschikbare extensies.

az vm extension image show

Informatie weergeven voor een extensie.

az vm extension list

Vermeld de extensies die zijn gekoppeld aan een VM.

az vm extension set

Extensies instellen voor een VM.

az vm extension show

Informatie weergeven over extensies die zijn gekoppeld aan een VM.

az vm extension wait

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

az vm extension delete

Verwijder een extensie die is gekoppeld aan een VM.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Voorbeelden

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

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

Verwijder extensies met een ID met de tekenreeks 'MyExtension' van een VM.

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

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

Naam van de extensie.

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--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 az account set -s NAME_OR_ID behulp van .

--vm-name

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

az vm extension list

Vermeld de extensies die zijn gekoppeld aan een VM.

az vm extension list --resource-group
                     --vm-name
                     [--query-examples]
                     [--subscription]

Voorbeelden

Voeg de gekoppelde extensies toe aan een benoemde VM.

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

Vereiste parameters

--resource-group -g

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

--vm-name

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

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

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

az vm extension set

Extensies instellen voor een VM.

Haal extensiegegevens op uit 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 Linux-VM.

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. Standaardinstelling: de naam van de extensie.

--force-update

Forceer het bijwerken, zelfs als de extensieconfiguratie niet is gewijzigd.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--no-auto-upgrade

Als deze optie is ingesteld, kiest of upgradet de extensieservice niet automatisch naar de meest recente secundaire versie, zelfs niet als de extensie opnieuw wordt geïmplementeerd.

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

Als deze optie is ingesteld, kiest of upgradet de extensieservice niet automatisch naar de meest recente secundaire versie, zelfs niet als de extensie opnieuw wordt geïmplementeerd.

geaccepteerde waarden: false, true
--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--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 az account set -s NAME_OR_ID behulp van .

--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 az configure --defaults vm=<name> behulp van .

az vm extension show

Informatie weergeven over extensies die zijn gekoppeld aan een VM.

az vm extension show [--expand]
                     [--ids]
                     [--name]
                     [--query-examples]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Voorbeelden

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

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

Optionele parameters

--expand

De uit te vouwen expressie die moet worden toegepast op de bewerking.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

Naam van de extensie.

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--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 az account set -s NAME_OR_ID behulp van .

--vm-name

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

az vm extension wait

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

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

Voorbeelden

Plaats de CLI in een wachttoestand 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 wachttoestand 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 wachttoestand 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 tot u met provisioningState bij Succeeded hebt gemaakt.

--custom

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

--deleted

Wacht tot u deze hebt verwijderd.

--exists

Wacht totdat de resource bestaat.

--expand

De uit te vouwen expressie die moet worden toegepast op de bewerking.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--interval

Pollinginterval 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 az account set -s NAME_OR_ID behulp van .

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

Wacht tot provisioningState is bijgewerkt bij Succeeded.

--vm-name

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