Condividi tramite


az extension

Consente di gestire e aggiornare le estensioni dell'interfaccia della riga di comando.

Comandi

Nome Descrizione Tipo Status
az extension add

Aggiungere un'estensione.

Nucleo GA
az extension list

Elencare le estensioni installate.

Nucleo GA
az extension list-available

Elencare le estensioni disponibili pubblicamente.

Nucleo GA
az extension list-versions

Elencare le versioni disponibili per un'estensione.

Nucleo GA
az extension remove

Rimuovere un'estensione.

Nucleo GA
az extension show

Mostra un'estensione.

Nucleo GA
az extension update

Aggiornare un'estensione.

Nucleo GA

az extension add

Aggiungere un'estensione.

Per informazioni sull'installazione automatica delle estensioni, visitare https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Esempio

Aggiungere l'estensione in base al nome

az extension add --name anextension

Aggiungere l'estensione dall'URL

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

Aggiungere l'estensione dal disco locale

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

Aggiungere l'estensione dal disco locale e usare il proxy pip per le dipendenze

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

Aggiungere l'estensione alla directory di sistema

az extension add --name anextension --system

Aggiungere una versione specifica dell'estensione

az extension add --name anextension --version 1.0.0

Aggiornare l'estensione se già installata

az extension add --upgrade --name anextension

Parametri facoltativi

--allow-preview

Includere pacchetti di anteprima per l'installazione dell'estensione, se esistente.

Valori accettati: false, true
--name -n

Nome dell'estensione.

--pip-extra-index-urls

Elenco delimitato da spazi di URL aggiuntivi degli indici del pacchetto da usare. Questo dovrebbe puntare a un repository conforme a PEP 503 (l'API del repository semplice) o a una directory locale disposta nello stesso formato.

--pip-proxy

Proxy per pip da usare per le dipendenze dell'estensione sotto forma di [user:passwd@]proxy.server:port.

--source -s

Percorso file o URL di un'estensione.

--system

Usare una directory di sistema per l'estensione.

Il percorso predefinito è la cartella azure-cli-extensions nell'interfaccia della riga di comando che esegue il percorso lib dell'ambiente Python, configurabile dalla variabile di ambiente AZURE_EXTENSION_SYS_DIR. In Windows potrebbe essere necessario aprire la shell come amministratore per l'esecuzione con l'autorizzazione corretta.

--upgrade

Aggiornare l'estensione se già installata. In caso contrario, è sufficiente installare l'estensione.

--version

Versione specifica di un'estensione.

Valore predefinito: latest
--yes -y

Non richiedere conferma.

Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az extension list

Elencare le estensioni installate.

az extension list
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az extension list-available

Elencare le estensioni disponibili pubblicamente.

az extension list-available [--show-details]

Esempio

Elencare tutte le estensioni disponibili pubblicamente

az extension list-available

Elencare i dettagli di una determinata estensione

az extension list-available --show-details --query anextension

Parametri facoltativi

--show-details -d

Mostra i dati non elaborati dall'indice di estensione.

Valore predefinito: False
Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az extension list-versions

Elencare le versioni disponibili per un'estensione.

az extension list-versions --name

Esempio

Elencare le versioni disponibili per un'estensione

az extension list-versions --name anextension

Parametri necessari

--name -n

Nome dell'estensione.

Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az extension remove

Rimuovere un'estensione.

az extension remove --name

Esempio

Rimuovere un'estensione. (generato automaticamente)

az extension remove --name MyExtension

Parametri necessari

--name -n

Nome dell'estensione.

Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az extension show

Mostra un'estensione.

az extension show --name

Esempio

Mostra un'estensione. (generato automaticamente)

az extension show --name MyExtension

Parametri necessari

--name -n

Nome dell'estensione.

Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az extension update

Aggiornare un'estensione.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Esempio

Aggiornare un'estensione in base al nome

az extension update --name anextension

Aggiornare un'estensione in base al nome e usare pip proxy per le dipendenze

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

Parametri necessari

--name -n

Nome dell'estensione.

Parametri facoltativi

--allow-preview

Includere pacchetti di anteprima per l'installazione dell'estensione, se esistente.

Valori accettati: false, true
--pip-extra-index-urls

Elenco delimitato da spazi di URL aggiuntivi degli indici del pacchetto da usare. Questo dovrebbe puntare a un repository conforme a PEP 503 (l'API del repository semplice) o a una directory locale disposta nello stesso formato.

--pip-proxy

Proxy per pip da usare per le dipendenze dell'estensione sotto forma di [user:passwd@]proxy.server:port.

Parametri globali
--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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