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
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.
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 |
Nome dell'estensione macchina virtuale.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Non attendere il completamento dell'operazione a esecuzione prolungata.
Proprietà | Valore |
---|---|
Valori accettati: | 0, 1, f, false, n, no, t, true, y, yes |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
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 |
Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Output format.
Proprietà | Valore |
---|---|
Valore predefinito: | json |
Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
az vm extension list
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.
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 |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
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 |
Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Output format.
Proprietà | Valore |
---|---|
Valore predefinito: | json |
Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
az vm extension set
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
Nome dell'estensione.
Proprietà | Valore |
---|---|
Valore da: | az vm extension image list |
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.
Indicare che l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.
Proprietà | Valore |
---|---|
Valori accettati: | false, true |
Nome dell'istanza dell'estensione, che può essere personalizzata. Impostazione predefinita: nome dell'estensione.
Forzare l'aggiornamento anche se la configurazione dell'estensione non è stata modificata.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
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 |
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 |
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 |
Non attendere il completamento dell'operazione a esecuzione prolungata.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Impostazioni protette in formato JSON per informazioni riservate come le credenziali. Viene accettato anche un percorso di file JSON.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Impostazioni di estensione in formato JSON. Viene accettato anche un percorso di file JSON.
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 |
Versione dell'estensione. Per aggiungere la versione dell'estensione a questo valore, specificare --no-auto-upgrade-minor-version.
Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Output format.
Proprietà | Valore |
---|---|
Valore predefinito: | json |
Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
az vm extension show
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.
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 |
Visualizzazione dell'istanza di un'estensione macchina virtuale.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Nome dell'estensione.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
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 |
Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Output format.
Proprietà | Valore |
---|---|
Valore predefinito: | json |
Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
az vm extension wait
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.
Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.
Proprietà | Valore |
---|---|
Parameter group: | Wait Condition Arguments |
Valore predefinito: | False |
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 |
Attendere l'eliminazione.
Proprietà | Valore |
---|---|
Parameter group: | Wait Condition Arguments |
Valore predefinito: | False |
Attendere che la risorsa esista.
Proprietà | Valore |
---|---|
Parameter group: | Wait Condition Arguments |
Valore predefinito: | False |
Espressione di espansione da applicare all'operazione.
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 |
Intervallo di polling in secondi.
Proprietà | Valore |
---|---|
Parameter group: | Wait Condition Arguments |
Valore predefinito: | 30 |
Nome dell'estensione macchina virtuale.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
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 |
Attesa massima in secondi.
Proprietà | Valore |
---|---|
Parameter group: | Wait Condition Arguments |
Valore predefinito: | 3600 |
Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.
Proprietà | Valore |
---|---|
Parameter group: | Wait Condition Arguments |
Valore predefinito: | False |
Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>
.
Proprietà | Valore |
---|---|
Parameter group: | Resource Id Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |
Output format.
Proprietà | Valore |
---|---|
Valore predefinito: | json |
Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
Proprietà | Valore |
---|---|
Valore predefinito: | False |