Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo illustra le terminologie dell'interfaccia della riga di comando di Azure. Sono disponibili componenti di sintassi, tipi di riferimento e stati.
Componenti della sintassi dell'interfaccia della riga di comando di Azure
La sintassi dell'interfaccia della riga di comando di Azure è una combinazione di gruppi, riferimenti, comandi e parametri. Spesso il comando di riferimento completo viene semplicemente definito comando.
Servizio di Azure | Gruppo di riferimenti | Sottogruppi di riferimento | Comando | Comando di riferimento completo | Esempi di parametri |
---|---|---|---|---|---|
Interfaccia CLI di Azure | az config | az config | --local, --output -o | ||
Rete di Azure | az network | application-gateway | creare | az network application-gateway create (comando per creare un gateway applicativo di rete) | --name (nome), --resource-group (gruppo risorse), --capacity (capacità) |
Azure DevOps | az pipelines | agente | lista | elenco agenti pipelines az | --pool-id, --agent-name, --demands |
Un sottogruppo di riferimento può avere più livelli, ad esempio az network application-gateway private-link ip-config add
Gruppo di riferimento | Sottogruppo 1 | Sottogruppo 2 | Sottogruppo 3 | Comando |
---|---|---|---|---|
rete | application-gateway | collegamento privato | configurazione IP | Aggiungere |
Per un elenco completo dei comandi di riferimento, vedere l'elenco di riferimenti da A a Z .
Che cos'è il tipo di riferimento?
I comandi dell'interfaccia della riga di comando di Azure fanno parte del servizio Azure CLI core, oppure sono un'estensione. Le estensioni sono componenti aggiuntivi facoltativi. Il tipo di riferimento determina la pianificazione del rilascio, lo stato e il metodo di installazione, come descritto di seguito:
Termine | Nucleo | Estensione |
---|---|---|
Riferimenti | Fanno parte del servizio principale di Azure CLI | Sono comandi di riferimento facoltativi che devono essere installati |
Installa | Insieme al programma di installazione MSI | Individualmente con az extension add |
Rilasciato | Secondo il programma | Quando diventano disponibili nuove funzionalità o aggiornamenti |
Stato | Può essere generalmente disponibile, in anteprima o obsoleta | Può anche essere disponibile a livello generale, anteprima o deprecato |
Per ottenere un elenco di gruppi di comandi, eseguire az
. Per un elenco di estensioni, usare az extension list-available --output table.
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Nucleo
I riferimenti dell'interfaccia della riga di comando di Azure pubblicati come parte permanente dell'interfaccia della riga di comando sono denominati riferimenti core. Tutti i riferimenti principali vengono installati con l'interfaccia della riga di comando di Azure e non è possibile scegliere un subset di riferimenti. Se si esegue l'interfaccia della riga di comando tramite Azure Cloud Shell, i riferimenti core sono sempre aggiornati.
Estensione
Le estensioni non sono incluse nella CLI, ma vengono eseguite come comandi CLI. Alcune estensioni sono una parte permanente dell'interfaccia della riga di comando di Azure, ma spesso un'estensione consente di accedere ai comandi di anteprima e sperimentali. Un singolo gruppo di riferimento, ad esempio az iot hub, può avere comandi core ed extension. Di seguito sono riportati due esempi:
Comando di riferimento completo | È Core | È un'estensione |
---|---|---|
Comando "az iot hub list" per elencare gli hub IoT. | Sì | |
az iot hub job list (Elenco dei lavori dell'hub IoT) | Sì |
Viene richiesto di installare un'estensione al primo uso. È anche possibile installare un'estensione eseguendo il comando az extension add .
Per altre informazioni sui riferimenti alle estensioni, tra cui installazione e aggiornamento, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure. Per un elenco completo dei comandi di riferimento di estensione, vedere Estensioni disponibili per l'interfaccia della riga di comando di Azure.
Che cos'è lo stato di riferimento?
Indipendentemente dal tipo di riferimento, i riferimenti all'interfaccia della riga di comando di Azure rientrano in tre categorie di stato: disponibilità generale (disponibile a livello generale), anteprima pubblica o deprecata. Si tratta dello stato del comando di riferimento (non di tipo) che determina la stabilità.
GA | Anteprima pubblica | Deprecato | |
---|---|---|---|
Stabilità | Permanente | Può cambiare in risposta al feedback dei clienti. È soggetto alle condizioni delle anteprime di Microsoft Azure. | Verrà rimosso. |
Annotazioni
Gli avvisi che indicano anteprima pubblica o obsoleto fanno parte dell'output del comando della CLI di Azure e devono essere considerati normali.
La maggior parte dei comandi e dei parametri per un singolo riferimento ha un singolo stato, ma non sempre. Un riferimento GA che viene sviluppato per offrire più comandi può includere comandi di disponibilità generale e di anteprima. Quando vengono aggiunti nuovi parametri per aumentare la funzionalità, un singolo comando può avere anche parametri che rientrano in categorie di stato diverse. Di seguito sono riportati alcuni riferimenti di esempio con stati diversi:
Comando di riferimento completo | Parametri | TIPO | GA | Anteprima pubblica | Deprecato |
---|---|---|---|---|---|
az rete dns elenco zone | Tutti | Nucleo | Sì | ||
Creare una zona DNS di rete con az network | --name, --resource-group, --if-none-match, --parent-name | Nucleo | Sì | ||
--existingParameter5 | Nucleo | Sì | |||
--newParameter6 | Nucleo | Sì | |||
az network vhub list (elenco vhubs di rete) | Tutti | Estensione | Sì | ||
az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Estensione | Sì | ||
--exsitingParameter7 | Estensione | Sì | |||
--newParameter8 | Estensione | Sì | |||
az crea firewall di rete | Tutti | Estensione | Sì |
La tabella precedente è solo un esempio e non è rappresentativo degli stati di riferimento correnti per az network
.