Introdução à CLI do AzureGet started with Azure CLI

Bem-vindo à CLI do Azure!Welcome to the Azure CLI! Este artigo apresenta a CLI e ajuda a concluir tarefas comuns.This article introduces the CLI and helps you complete common tasks.

Observação

Em scripts e no site de documentação da Microsoft, os exemplos da CLI do Azure são escritos para o shell bash.In scripts and on the Microsoft documentation site, Azure CLI examples are written for the bash shell. Os exemplos de uma linha serão executados em qualquer plataforma.One-line examples will run on any platform. Os exemplos mais longos, que incluem continuações da linha (\) ou a atribuição de variáveis precisam ser modificados para funcionar em outros shells, incluindo o PowerShell.Longer examples which include line continuations (\) or variable assignment need to be modified to work on other shells, including PowerShell.

Instalar ou executar no Azure Cloud ShellInstall or run in Azure Cloud Shell

A maneira mais fácil começar a usar a CLI do Azure é executando-a em um ambiente do Azure Cloud Shell por meio do seu navegador.The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. Para saber mais sobre o Cloud Shell, consulte Início Rápido para Bash no Azure Cloud Shell.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Quando você estiver pronto para instalar a CLI, confira as instruções de instalação.When you're ready to install the CLI, see the installation instructions.

Depois de instalar a CLI pela primeira vez, verifique se ela está instalada e se você tem a versão correta, executando az --version.After installing the CLI for the first time, check that it's installed and you've got the correct version by running az --version.

Observação

Se você estiver usando o modelo de implantação clássico do Azure, instale a CLI clássica do Azure.If you're using the Azure classic deployment model, install the Azure classic CLI.

EntrarSign in

Antes de usar os comandos da CLI com uma instalação local, é preciso entrar com az login.Before using any CLI commands with a local install, you need to sign in with az login.

  1. Execute o comando login.Run the login command.

    az login
    

    Se a CLI puder abrir o navegador padrão, ela o fará e carregará uma página de entrada do Azure.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    Caso contrário, abra uma página de navegador em https://aka.ms/devicelogin e insira o código de autorização exibido no terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Entre com suas credenciais de conta no navegador.Sign in with your account credentials in the browser.

Depois de entrar, você deve ver uma lista de assinaturas associadas à sua conta do Azure.After logging in, you see a list of subscriptions associated with your Azure account. A informação de assinatura com isDefault: true é a assinatura ativada no momento depois de entrar.The subscription information with isDefault: true is the currently activated subscription after logging in. Para selecionar outra assinatura, use o comando az account set com a ID da assinatura para a qual alternar.To select another subscription, use the az account set command with the subscription ID to switch to. Para obter mais informações sobre a seleção da assinatura, confira Usar várias assinaturas do Azure.For more information about subscription selection, see Use multiple Azure subscriptions.

Há maneiras de entrar de modo não interativo, como mostrado em detalhes em Entrar com a CLI do Azure.There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

Comandos comunsCommon commands

Esta tabela lista alguns comandos comuns usados na CLI e está vinculada à documentação de referência.This table lists some common commands used in the CLI and links to their reference documentation.

Tipo de recursoResource type Grupo de comando da CLI do AzureAzure CLI command group
Grupo de recursosResource group az groupaz group
Máquinas virtuaisVirtual machines az vmaz vm
Contas de armazenamentoStorage accounts az storage accountaz storage account
Key VaultKey Vault az keyvaultaz keyvault
Aplicativos WebWeb applications az webappaz webapp
Bancos de dados SQLSQL databases az sql serveraz sql server
CosmosDBCosmosDB az cosmosdbaz cosmosdb

Encontrando comandosFinding commands

Os comandos na CLI são organizados como comandos de grupos.Commands in the CLI are organized as commands of groups. Cada grupo representa um serviço do Azure e os comandos operam nesse serviço.Each group represents an Azure service, and commands operate on that service.

Para procurar comandos, use az find.To search for commands, use az find. Por exemplo, para procurar nomes de comando que contenham secret, use o seguinte comando:For example, to search for command names containing secret, use the following command:

az find secret

Use o argumento --help para obter uma lista completa de comandos e subgrupos de um grupo.Use the --help argument to get a complete list of commands and subgroups of a group. Por exemplo, para localizar os comandos da CLI para trabalhar com Grupos de Segurança de Rede (NSGs):For example, to find the CLI commands for working with Network Security Groups (NSGs):

az network nsg --help

A CLI tem o preenchimento completo de guia para comandos sob o shell do Bash.The CLI has full tab completion for commands under the bash shell.

Argumentos disponíveis globalmenteGlobally available arguments

Há alguns argumentos disponíveis para cada comando.There are some arguments that are available for every command.

  • --help imprime as informações de referência da CLI sobre comandos e seus argumentos, além de listar os comandos e subgrupos disponíveis.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • --output altera o formato de saída.--output changes the output format. Os formatos de saída disponíveis são json, jsonc(JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legível por humanos) e yaml.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Por padrão, a CLI gera json.By default the CLI outputs json. Para saber mais sobre os formatos de saída disponíveis, confira Formatos de saída da CLI do Azure.To learn more about the available output formats, see Output formats for Azure CLI.
  • --query usa o linguagem de consulta JMESPath para filtrar a saída retornada dos serviços do Azure.--query uses the JMESPath query language to filter the output returned from Azure services. Para saber mais sobre as consultas, confira Consultar resultados do comando com a CLI do Azure e Tutorial do JMESPath.To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • --verbose imprime informações sobre recursos criados no Azure durante uma operação, além de outras informações úteis.--verbose prints information about resources created in Azure during an operation, and other useful information.
  • --debug imprime ainda mais informações sobre operações de CLI e é usado para fins de depuração.--debug prints even more information about CLI operations, used for debugging purposes. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

Modo interativoInteractive mode

A CLI oferece um modo interativo que exibe informações de ajuda automaticamente e torna mais fácil selecionar subcomandos.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. Você entra no modo interativo com o comando az interactive.You enter interactive mode with the az interactive command.

az interactive

Para obter mais informações sobre o modo interativo, confira Modo interativo da CLI do Azure.For more information on interactive mode, see Azure CLI Interactive Mode.

Também há um plug-in do Visual Studio Code que oferece uma experiência interativa, incluindo documentação de preenchimento automático e com o passar do mouse.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

Aprenda as noções básica da CLI com os guias de início rápido e tutoriaisLearn CLI basics with quickstarts and tutorials

Para a introdução à CLI do Azure, experimente ver um tutorial aprofundado para configurar máquinas virtuais e usar o poder da CLI para consultar recursos do Azure.To get you started with the Azure CLI, try an in-depth tutorial for setting up virtual machines and using the power of the CLI to query Azure resources.

Também há guias de início rápido para outros serviços populares.There are also quickstarts for other popular services.

Fornecer comentáriosGive feedback

Apreciamos seus comentários da CLI para ajudar-nos a melhorar e resolver bugs.We welcome your feedback for the CLI to help us make improvements and resolve bugs. Você pode arquivar um problema no GitHub ou usar os recursos internos da CLI para deixar um comentário geral com o comando az feedback.You can file an issue on GitHub or use the built-in features of the CLI to leave general feedback with the az feedback command.

az feedback

Confira tambémSee also