az vm extension

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 software, la protezione antivirus o la configurazione di Docker, è possibile usare un'estensione macchina virtuale per completare queste attività. Le estensioni possono essere raggruppate con una nuova distribuzione di macchine virtuali o eseguite su qualsiasi sistema esistente.

Comandi

Nome	Descrizione	Tipo	Status
az vm extension delete	Eliminare l'operazione per eliminare l'estensione.	Core	GA
az vm extension image	Trovare le estensioni di macchina virtuale disponibili per una sottoscrizione e un'area.	Core	GA
az vm extension image list	Elencare le informazioni sulle estensioni disponibili.	Core	GA
az vm extension image list-names	Elencare i nomi delle estensioni disponibili.	Core	GA
az vm extension image list-versions	Elencare le versioni per le estensioni disponibili.	Core	GA
az vm extension image show	Visualizzare le informazioni per un'estensione.	Core	GA
az vm extension list	Elencare le estensioni collegate a una macchina virtuale.	Core	GA
az vm extension set	Impostare le estensioni per una macchina virtuale.	Core	GA
az vm extension show	Visualizzare informazioni sulle estensioni collegate a una macchina virtuale.	Core	GA
az vm extension wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Core	GA

az vm extension delete

Modifica

Eliminare l'operazione per eliminare l'estensione.

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]

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

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

--ids

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

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

Nome dell'estensione macchina virtuale.

Proprietà	Valore
Parameter group:	Resource Id Arguments

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
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 usando az configure --defaults group=<name>.

Proprietà	Valore
Parameter group:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--vm-name

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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

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

--ids

Proprietà	Valore
Parameter group:	Resource Id Arguments

--resource-group -g

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--vm-name

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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.

Proprietà	Valore
Valore da:	az vm extension image list

--publisher

Nome del server di pubblicazione dell'estensione.

Parametri facoltativi

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

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

Proprietà	Valore
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.

Proprietà	Valore
Valore predefinito:	False

--ids

Proprietà	Valore
Parameter group:	Resource Id Arguments

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

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

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

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
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 usando az configure --defaults group=<name>.

Proprietà	Valore
Parameter group:	Resource Id Arguments

--settings

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

--subscription

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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

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

--ids

Proprietà	Valore
Parameter group:	Resource Id Arguments

--instance-view

Visualizzazione dell'istanza di un'estensione macchina virtuale.

Proprietà	Valore
Valore predefinito:	False

--name -n

Nome dell'estensione.

Proprietà	Valore
Parameter group:	Resource Id Arguments

--resource-group -g

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--vm-name

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

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.

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

Parametri facoltativi

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

--created

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

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--custom

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

Proprietà	Valore
Parameter group:	Wait Condition Arguments

--deleted

Attendere l'eliminazione.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--exists

Attendere che la risorsa esista.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--expand

Espressione di espansione da applicare all'operazione.

--ids

Proprietà	Valore
Parameter group:	Resource Id Arguments

--interval

Intervallo di polling in secondi.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	30

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

Nome dell'estensione macchina virtuale.

Proprietà	Valore
Parameter group:	Resource Id Arguments

--resource-group -g

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

--timeout

Attesa massima in secondi.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	3600

--updated

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

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--vm-name

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

Proprietà	Valore
Parameter group:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

Condividi tramite

az vm extension

Comandi

az vm extension delete

Esempio

Parametri facoltativi

az vm extension list

Esempio

Parametri facoltativi

az vm extension set

Esempio

Parametri necessari

Parametri facoltativi

az vm extension show

Esempio

Parametri facoltativi

az vm extension wait

Parametri facoltativi

Commenti e suggerimenti