az vm extension

  • Riferimento

Gestire le estensioni nelle macchine virtuali.

Le estensioni sono piccole applicazioni che forniscono attività di configurazione e automazione post-distribuzione nelle macchine virtuali di Azure. Ad esempio, se una macchina virtuale richiede l'installazione di software, la protezione antivirus o la configurazione di Docker, è possibile usare un'estensione di macchina virtuale per completare queste attività. Le estensioni possono essere unite in bundle con una nuova distribuzione di macchina virtuale o eseguite su un sistema esistente.

Comandi

Nome Descrizione Tipo Stato
az vm extension delete

Eliminare l'operazione per eliminare l'estensione.

 Memoria centrale Disponibilità generale
az vm extension image

Trovare le estensioni di macchina virtuale disponibili per una sottoscrizione e un'area.

 Memoria centrale Disponibilità generale
az vm extension image list

Elencare le informazioni sulle estensioni disponibili.

 Memoria centrale Disponibilità generale
az vm extension image list-names

Elencare i nomi delle estensioni disponibili.

 Memoria centrale Disponibilità generale
az vm extension image list-versions

Elencare le versioni per le estensioni disponibili.

 Memoria centrale Disponibilità generale
az vm extension image show

Visualizzare le informazioni per un'estensione.

 Memoria centrale Disponibilità generale
az vm extension list

Elencare le estensioni collegate a una macchina virtuale.

 Memoria centrale Disponibilità generale
az vm extension set

Impostare le estensioni per una macchina virtuale.

 Memoria centrale Disponibilità generale
az vm extension show

Visualizzare informazioni sulle estensioni collegate a una macchina virtuale.

 Memoria centrale Disponibilità generale
az vm extension wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di estensione macchina virtuale.

 Memoria centrale Disponibilità generale

az vm extension delete

Modifica

Eliminare l'operazione per eliminare l'estensione.

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

Esempio

Usare un nome di macchina virtuale e un'estensione per eliminare un'estensione da una macchina virtuale.

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

Eliminare le estensioni con ID contenenti la stringa "MyExtension" da una macchina virtuale.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

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

Nome dell'estensione macchina virtuale.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

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

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--vm-name

Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vm extension list

Modifica

Elencare le estensioni collegate a una macchina virtuale.

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

Esempio

Elencare le estensioni associate a una macchina virtuale denominata.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--vm-name

Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vm extension set

Modifica

Impostare le estensioni per una macchina virtuale.

Ottenere i dettagli dell'estensione da 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]

Esempio

Aggiungere un account utente a una macchina virtuale Linux.

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

Aggiungere un'estensione customScript alle macchine virtuali specificate da --ids.

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

Aggiungere un'estensione e abilitare l'aggiornamento automatico dalla piattaforma se è disponibile una versione più recente dell'estensione.

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

Parametri necessari

--name -n

Nome dell'estensione.

valore da: az vm extension image list
--publisher

Nome del server di pubblicazione dell'estensione.

Parametri facoltativi

--enable-auto-upgrade

Indicare che l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.

valori accettati: false, true
--extension-instance-name

Nome dell'istanza dell'estensione, che può essere personalizzata. Impostazione predefinita: nome dell'estensione.

--force-update

Forzare l'aggiornamento anche se la configurazione dell'estensione non è stata modificata.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--no-auto-upgrade
Deprecato

L'opzione '--no-auto-upgrade' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--no-auto-upgrade-minor-version'.

Se impostato, il servizio di estensione non verrà selezionato o aggiornato automaticamente alla versione secondaria più recente, anche se l'estensione viene ridistribuita.

valori accettati: false, true
valore predefinito: False
--no-auto-upgrade-minor-version

Se impostato, il servizio di estensione non verrà selezionato o aggiornato automaticamente alla versione secondaria più recente, anche se l'estensione viene ridistribuita.

valori accettati: false, true
valore predefinito: False
--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--protected-settings

Impostazioni protette in formato JSON per informazioni riservate come le credenziali. Viene accettato anche un percorso di file JSON.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--settings

Impostazioni di estensione in formato JSON. Viene accettato anche un percorso di file JSON.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--version

Versione dell'estensione. Per aggiungere la versione dell'estensione a questo valore, specificare --no-auto-upgrade-minor-version.

--vm-name

Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vm extension show

Modifica

Visualizzare informazioni sulle estensioni collegate a una macchina virtuale.

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

Esempio

Usare il nome della macchina virtuale e il nome dell'estensione per visualizzare le estensioni collegate a una macchina virtuale.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--instance-view

Visualizzazione dell'istanza di un'estensione macchina virtuale.

valore predefinito: False
--name -n

Nome dell'estensione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--vm-name

Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vm extension wait

Modifica

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di estensione macchina virtuale.

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

Esempio

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di estensione macchina virtuale. (generato automaticamente)

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

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di estensione macchina virtuale. (generato automaticamente)

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

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione di estensione macchina virtuale. (generato automaticamente)

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--exists

Attendere che la risorsa esista.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

valore predefinito: 30
--name -n

Nome dell'estensione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

valore predefinito: False
--vm-name

Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.