Introdução ao Azure CLIGet started with Azure CLI

Bem-vindo à CLI do Azure!Welcome to the Azure CLI! A CLI é uma ferramenta concebida para ajudá-lo a trabalhar de forma rápida e com os serviços do Azure, com ênfase na automatização.The CLI is a tool designed to get you working quickly and efficiently with Azure services, with an emphasis on automation. Esta artigo apresenta as funcionalidades da CLI e liga a recursos que o ajudam a ser produtivo.This article introduces features of the CLI and links out to resources that help you be productive.

Nota

Nos 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 em uma linha executam em qualquer plataforma.One-line examples will run on any platform. Os maiores exemplos que incluem linhas contínuas (\) ou atribuições de variáveis precisam de 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 forma mais fácil de começar a utilizar a CLI do Azure é executá-la num ambiente do Azure Cloud Shell através do browser.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, veja Início Rápido do Bash no Azure Cloud Shell.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Quando estiver preparado para instalar a CLI, veja 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.

Iniciar sessãoSign in

Antes de utilizar qualquer comando da CLI com uma instalação local, precisa de iniciar sessão 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 fará isso 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 do https://aka.ms/devicelogin navegador em e insira o código de autorização exibido no seu terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. Inicie sessão com as credenciais da sua conta no browser.Sign in with your account credentials in the browser.

Depois de fazer logon, você verá uma lista de assinaturas associadas à sua conta do Azure.After logging in, you see a list of subscriptions associated with your Azure account. As informações de assinatura isDefault: true com o são a assinatura ativada no momento após o logon.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 de assinatura para alternar para.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 de assinatura, consulte usar várias assinaturas do Azure.For more information about subscription selection, see Use multiple Azure subscriptions.

Existem formas de iniciar sessão de forma não interativa, que são abordadas em detalhe em Iniciar sessão 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 utilizados na CLI, bem como ligações para a documentação de referência dos mesmos.This table lists some common commands used in the CLI and links to their reference documentation.

Tipo de recursoResource type Grupo de comandos 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
Cofre de ChavesKey Vault az keyvaultaz keyvault
Aplicações WebWeb applications az webappaz webapp
Bases de Dados SQLSQL databases az sql serveraz sql server
CosmosDBCosmosDB az cosmosdbaz cosmosdb

Encontrar os comandosFinding commands

Os comandos da CLI estã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 os comandos, utilize az find.To search for commands, use az find. Por exemplo, para procurar os nomes dos comando que contenham secret, utilize o seguinte comando:For example, to search for command names containing secret, use the following command:

az find secret

Utilize 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 conclusão de separadores completa para comandos na shell de deteção.The CLI has full tab completion for commands under the bash shell.

Argumentos globalmente disponíveisGlobally available arguments

Existem alguns argumentos que estão disponíveis para todos os comandos.There are some arguments that are available for every command.

  • --help imprime as informações de referência da CLI sobre comandos e os respetivos argumentos, bem como apresenta uma lista dos comandos e subgrupos disponíveis.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • --output muda o formato de saída.--output changes the output format. Os formatos de saída disponíveis jsonsão jsonc , (JSON colorido), tsv (valores separados por tabulação) table , (tabelas ASCII legíveis para pessoas) e yaml.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Por predefinição, a CLI produz json.By default the CLI outputs json. Para saber mais sobre os formatos de saída disponíveis, veja Formatos de saída para a CLI do Azure.To learn more about the available output formats, see Output formats for Azure CLI.
  • --query utiliza a Linguagem de Consulta JMESPath para filtrar os resultados devolvidos pelo serviços do Azure.--query uses the JMESPath query language to filter the output returned from Azure services. Para saber mais sobre consultas, consulte resultados do comando de consulta com CLI do Azure e o tutorial JMESPath.To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • --verbose imprime informações sobre os recursos criados no Azure durante uma operação e 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 as operações da CLI utilizadas para efeitos de depuração.--debug prints even more information about CLI operations, used for debugging purposes. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.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 interativa que mostra automaticamente as informações de ajuda e torna mais fácil selecionar os subcomandos.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. Pode entrar 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, veja Modo Interativo da CLI do Azure.For more information on interactive mode, see Azure CLI Interactive Mode.

Há também um plug-in do Visual Studio Code que oferece uma experiência interativa, incluindo documentação de conclusão automática e à passagem do rato.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

Aprender as noções básicas da CLI com inícios rápidos e tutoriaisLearn CLI basics with quickstarts and tutorials

Para começar a utilizar a CLI do Azure, experimente um tutorial aprofundado para configurar máquinas virtuais e utilizar 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 existem inícios rápidos para outros serviços populares.There are also quickstarts for other popular services.

Enviar comentáriosGive feedback

Apreciamos os seus comentários para a CLI para ajudar-nos a melhorar e resolver erros.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 comentários gerais 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