Condividi tramite


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.

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

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

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

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

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

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

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

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

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