Condividi tramite

az scvmm vm extension

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione scvmm per l'interfaccia della riga di comando di Azure (versione 2.15.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az scvmm vm extension . Altre informazioni sulle estensioni.

Gestire l'estensione vm con scvmm.

Comandi

Nome Descrizione Tipo Status
az scvmm vm extension create

Operazione per creare l'estensione.

 Estensione Disponibilità generale
az scvmm vm extension delete

Operazione per eliminare l'estensione.

 Estensione Disponibilità generale
az scvmm vm extension list

Operazione per ottenere tutte le estensioni di una macchina virtuale non Di Azure.

 Estensione Disponibilità generale
az scvmm vm extension show

Operazione per ottenere l'estensione.

 Estensione Disponibilità generale
az scvmm vm extension update

Operazione per aggiornare l'estensione.

 Estensione Disponibilità generale

az scvmm vm extension create

Operazione per creare l'estensione.

az scvmm vm extension create --location
                             --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Esempio

Creare un'estensione macchina virtuale

az scvmm vm extension create --name contoso-extension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--name

Nome dell'estensione vm.

--resource-group -g

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

--vm-name

Nome della macchina virtuale in cui deve essere creata o aggiornata l'estensione.

Parametri facoltativi

--auto-upgrade-minor

Indicare se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.

Valori accettati: false, true
--enable-auto-upgrade

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

Valori accettati: false, true
--force-update-tag

Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata.

--no-wait

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

Valore predefinito: False
--protected-settings

L'estensione può contenere impostazioni protette Impostazioni o protette Impostazioni FromKeyVault o nessuna impostazione protetta. Valore previsto: json-string/json-file/@json-file.

--publisher

Nome del server di pubblicazione del gestore dell'estensione.

--settings

Impostazioni pubbliche in formato JSON per l'estensione. Valore previsto: json-string/json-file/@json-file.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--type

Specificare il tipo di estensione; un esempio è "CustomScriptExtension".

--type-handler-version

Specifica la versione del gestore di script.

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 scvmm vm extension delete

Operazione per eliminare l'estensione.

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

Esempio

Eliminare un'estensione macchina virtuale

az scvmm vm extension delete --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

Nome dell'estensione vm.

--no-wait

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

Valore predefinito: False
--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 in cui deve essere eliminata l'estensione.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
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 scvmm vm extension list

Operazione per ottenere tutte le estensioni di una macchina virtuale non Di Azure.

az scvmm vm extension list --resource-group
                           --vm-name
                           [--expand]

Esempio

Ottenere tutte le estensioni della macchina virtuale

az scvmm vm extension list --vm-name contoso-vm --resource-group contoso-rg

Parametri necessari

--resource-group -g

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

--vm-name

Nome della macchina virtuale contenente l'estensione.

Parametri facoltativi

--expand

Espressione di espansione da applicare all'operazione.

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 scvmm vm extension show

Operazione per ottenere l'estensione.

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

Esempio

Ottenere l'estensione macchina virtuale

az scvmm vm extension show --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

Nome dell'estensione vm.

--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 contenente l'estensione.

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 scvmm vm extension update

Operazione per aggiornare l'estensione.

az scvmm vm extension update --name
                             --resource-group
                             --vm-name
                             [--auto-upgrade-minor {false, true}]
                             [--enable-auto-upgrade {false, true}]
                             [--force-update-tag]
                             [--no-wait]
                             [--protected-settings]
                             [--publisher]
                             [--settings]
                             [--tags]
                             [--type]
                             [--type-handler-version]

Esempio

Aggiornare un'estensione macchina virtuale

az scvmm vm extension update --name contoso-extension --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Parametri necessari

--name

Nome dell'estensione vm.

--resource-group -g

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

--vm-name

Nome della macchina virtuale in cui deve essere creata o aggiornata l'estensione.

Parametri facoltativi

--auto-upgrade-minor

Indicare se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.

Valori accettati: false, true
--enable-auto-upgrade

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

Valori accettati: false, true
--force-update-tag

Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata.

--no-wait

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

Valore predefinito: False
--protected-settings

L'estensione può contenere impostazioni protette Impostazioni o protette Impostazioni FromKeyVault o nessuna impostazione protetta. Valore previsto: json-string/json-file/@json-file.

--publisher

Nome del server di pubblicazione del gestore dell'estensione.

--settings

Impostazioni pubbliche in formato JSON per l'estensione. Valore previsto: json-string/json-file/@json-file.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--type

Specificare il tipo di estensione; un esempio è "CustomScriptExtension".

--type-handler-version

Specifica la versione del gestore di script.

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.