Condividi tramite


Che cos'è l'interfaccia della riga di comando di Azure?

L'interfaccia della riga di comando di Azure è uno strumento da riga di comando multipiattaforma per connettersi ad Azure ed eseguire comandi amministrativi nelle risorse di Azure. Consente l'esecuzione di comandi tramite un terminale usando prompt interattivi da riga di comando o uno script.

Per l'uso interattivo, avviare prima una shell come cmd.exe in Windows o Bash in Linux o macOS e quindi eseguire un comando al prompt della shell. Per automatizzare le attività ripetitive, si assemblano i comandi dell'interfaccia della riga di comando in uno script della shell usando la sintassi di script della shell scelta e quindi si esegue lo script.

È possibile installare l'interfaccia della riga di comando di Azure in locale in computer Linux, macOS o Windows. Può essere usato anche da un browser tramite Azure Cloud Shell o eseguito dall'interno di un contenitore Docker.

Versione corrente

La versione corrente dell'interfaccia della riga di comando di Azure è 2.63.0. Per informazioni sulla versione più recente, vedere le note sulla versione. Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Autenticazione

L'interfaccia della riga di comando di Azure supporta diversi metodi di autenticazione. Per informazioni dettagliate sull'autenticazione in Azure dall'interfaccia della riga di comando di Azure, vedere Accedere con l'interfaccia della riga di comando di Azure.

Progettazione dei riferimenti ai comandi

La sintassi dell'interfaccia della riga di comando di Azure segue un modello semplicereference nameparameter - parameter valuecommand - - . Ad esempio, il passaggio da una sottoscrizione all'altra è spesso un'attività comune. La sintassi è la seguente.

az account set --subscription "my subscription name"

Un altro uso comune dell'interfaccia della riga di comando di Azure è la gestione delle assegnazioni di ruolo.

az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor

Per altre informazioni sulla gestione delle sottoscrizioni, vedere Gestire le sottoscrizioni con l'interfaccia della riga di comando di Azure. Per un'esercitazione approfondita sulla gestione delle entità servizio e delle assegnazioni di ruolo, vedere Creare un'entità servizio di Azure con l'interfaccia della riga di comando di Azure .

Confronto della sintassi di PowerShell

Scegliere lo strumento da riga di comando corretto illustra la differenza tra tools e environments con un'enfasi sull'interfaccia della riga di comando di Azure e Su Azure PowerShell. Offre anche molti confronti tra comandi side-by-side. Di seguito sono riportati due esempi:

Comando Interfaccia della riga di comando di Azure Azure PowerShell
Finestra Crea gruppo di risorse az group create --name <ResourceGroupName> --location eastus New-AzResourceGroup -Name <ResourceGroupName> -Location eastus
Creare un account di archiviazione di Azure az storage account create --name <StorageAccountName> --resource-group <ResourceGroupName> --location eastus --sku Standard_LRS --kind StorageV2 New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName ResourceGroupName> <-Location eastus -SkuName Standard_LRS -Kind StorageV2

Per i confronti della sintassi dell'interfaccia della riga di comando di Azure tra ambienti Bash e PowerShell, vedere Informazioni sulle differenze di sintassi dell'interfaccia della riga di comando di Azure in Bash, PowerShell e Cmd.

Formati di output

L'interfaccia della riga di comando di Azure usa JSON come formato di output predefinito, ma offre altri formati, come descritto in Formati di output per i comandi dell'interfaccia della riga di comando di Azure. Usare il parametro per formattare i risultati del --output comando dell'interfaccia della riga di comando di Azure. Ecco un esempio:

az account list --output table

Impostare l'output predefinito impostando la proprietà di configurazione come descritto in Configurazione dell'interfaccia della output riga di comando di Azure.

az config set core.output=jsonc

Raccolta dati

L'interfaccia della riga di comando di Azure raccoglie i dati di telemetria per impostazione predefinita. Microsoft aggrega i dati raccolti per identificare i modelli di utilizzo per identificare i problemi comuni e migliorare l'esperienza dell'interfaccia della riga di comando di Azure. L'interfaccia della riga di comando di Microsoft Azure non raccoglie dati privati o personali. Ad esempio, i dati di utilizzo consentono di identificare problemi come i comandi con esito negativo e aiutano a classificare in ordine di priorità il lavoro.

Anche se apprezziamo le informazioni fornite da questi dati, sappiamo anche che non tutti sono disposti a inviare dati di utilizzo. È possibile disabilitare la raccolta dati con il az config set core.collect_telemetry=false comando . È anche possibile leggere l'informativa sulla privacy per altre informazioni.

Vedi anche