az connectedmachine extension

Nota

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

Gestire un'estensione macchina virtuale in un server abilitato per Azure Arc.

Comandi

Nome	Descrizione	Tipo	Stato
az connectedmachine extension create	Operazione per creare l'estensione.	Estensione	Disponibilità generale
az connectedmachine extension delete	Operazione per eliminare l'estensione.	Estensione	Disponibilità generale
az connectedmachine extension image	Gestire i metadati dell'estensione macchina virtuale disponibili per i server abilitati per Azure Arc.	Estensione	Disponibilità generale
az connectedmachine extension image list	Elencare tutte le versioni dell'estensione in base a location, publisher, extensionType.	Estensione	Disponibilità generale
az connectedmachine extension image show	Ottenere i metadati dell'estensione in base alla posizione, all'editore, al tipo di estensione e alla versione.	Estensione	Disponibilità generale
az connectedmachine extension list	Operazione per ottenere tutte le estensioni di un computer non Azure.	Estensione	Disponibilità generale
az connectedmachine extension show	Operazione per creare o aggiornare l'estensione.	Estensione	Disponibilità generale
az connectedmachine extension update	Aggiornare l'operazione per aggiornare l'estensione.	Estensione	Disponibilità generale
az connectedmachine extension wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Estensione	Disponibilità generale

az connectedmachine extension create

Operazione per creare l'estensione.

az connectedmachine extension create --extension-name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--auto-upgrade-minor {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--instance-view]
                                     [--location]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Esempio

Comando di esempio per la creazione dell'estensione

az connectedmachine extension create --name CustomScriptExtension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

Parametri necessari

--extension-name --name -n

Nome dell'estensione del computer.

--machine-name

Nome del computer in cui deve essere creata o aggiornata l'estensione.

--resource-group -g

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

Parametri facoltativi

--auto-upgrade --enable-auto-upgrade --enable-automatic-upgrade

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

valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--auto-upgrade-minor --auto-upgrade-minor-version --upgrade-minor-ver

Indica 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: 0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

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

--instance-view

Visualizzazione dell'istanza dell'estensione del computer. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--location -l

Posizione geografica in cui si trova la risorsa Se non specificato, verrà usata la posizione del gruppo di risorse.

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

--protected-settings

L'estensione può contenere impostazioni protette Impostazioni o protette Impostazioni FromKeyVault o nessuna impostazione protetta. Supporto di json-file e yaml-file.

--publisher

Nome del server di pubblicazione del gestore dell'estensione.

--settings

Impostazioni pubbliche in formato JSON per l'estensione. Supporto di json-file e yaml-file.

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--type

Specifica 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 connectedmachine extension delete

Operazione per eliminare l'estensione.

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

Esempio

Comando di esempio per l'eliminazione dell'estensione

az connectedmachine extension delete --name myName --machine-name myMachine --resource-group myResourceGroup

Parametri facoltativi

--extension-name --name -n

Nome dell'estensione del computer.

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

--machine-name

Nome del computer in cui deve essere eliminata l'estensione.

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

--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 connectedmachine extension list

Operazione per ottenere tutte le estensioni di un computer non Azure.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]

Esempio

Comando di esempio per l'elenco di estensioni

az connectedmachine extension list --machine-name myMachine --resource-group myResourceGroup

Parametri necessari

--machine-name

Nome del computer contenente l'estensione.

--resource-group -g

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

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 connectedmachine extension show

Operazione per creare o aggiornare l'estensione.

az connectedmachine extension show [--extension-name]
                                   [--ids]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]

Esempio

Comando di esempio per la visualizzazione dell'estensione

az connectedmachine extension show --name CustomScriptExtension --machine-name myMachine --resource-group myResourceGroup

Parametri facoltativi

--extension-name --name -n

Nome dell'estensione del computer.

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

--machine-name

Nome del computer contenente l'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.

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 connectedmachine extension update

Aggiornare l'operazione per aggiornare l'estensione.

az connectedmachine extension update [--add]
                                     [--auto-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--auto-upgrade-minor {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--extension-name]
                                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--ids]
                                     [--instance-view]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--remove]
                                     [--resource-group]
                                     [--set]
                                     [--settings]
                                     [--subscription]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Esempio

Comando di esempio per l'aggiornamento dell'estensione

az connectedmachine extension update --name CustomScriptExtension --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, stringa o stringa> JSON.

--auto-upgrade --enable-auto-upgrade --enable-automatic-upgrade

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

valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--auto-upgrade-minor --auto-upgrade-minor-version --upgrade-minor-ver

Indica 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: 0, 1, f, false, n, no, t, true, y, yes

--extension-name --name -n

Nome dell'estensione del computer.

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

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

--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 dell'estensione del computer. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--machine-name

Nome del computer contenente l'estensione.

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

--protected-settings

L'estensione può contenere impostazioni protette Impostazioni o protette Impostazioni FromKeyVault o nessuna impostazione protetta. Supporto di json-file e yaml-file.

--publisher

Nome del server di pubblicazione del gestore dell'estensione.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=.

--settings

Impostazioni pubbliche in formato JSON per l'estensione. Supporto di json-file e yaml-file.

--subscription

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

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--type

Specifica 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 connectedmachine extension wait

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

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

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

--extension-name --name -n

Nome dell'estensione del computer.

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

--machine-name

Nome del computer contenente l'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

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.