Folha de referências de integração da CLI do Azure
Se você quiser se integrar rapidamente com a CLI do Azure, chegou ao lugar certo! Use esta página para aprender dicas e técnicas ao começar a usar a CLI do Azure.
Índices de conteúdo
Pule diretamente para referenciar exemplos de comando, scripts de exemplo e tutoriais usando estes links:
- Encontre um índice de guias de início rápido, guias de instruções e tutoriais no índice de documentos da CLI do Azure A-Z.
- Escolha um script testado e torne-o seu no índice de exemplo da CLI do Azure A-Z.
- Para obter um formato publicado de ajuda em linha, acesse o índice de referência A-Z.
- Acesse Módulos do Microsoft Learn para ferramentas da CLI para obter treinamento on-line gratuito com um ambiente de área restrita.
Introdução
| Pergunta | Resposta | Saiba mais |
|---|---|---|
| Qual é a vantagem de usar a CLI do Azure? | Você pode gerenciar vários recursos do Azure simultaneamente a partir de uma linha de comando flexível. Por exemplo, crie 50 contas de armazenamento do Azure ou atualize várias permissões de usuário por meio de um script. | Escolher a ferramenta de linha de comando correta |
| Onde posso executar a CLI do Azure? | A CLI do Azure é executada no Windows (Cmd ou PowerShell), Linux, macOS, contêineres do Docker e Azure Cloud Shell. Usar o Azure Cloud Shell é a maneira mais rápida de começar. | Executar o Azure Cloud Shell |
| Preciso instalar a CLI do Azure? | O Azure Cloud Shell e algumas distribuições do Linux têm a CLI do Azure pré-instalada. Para todos os outros ambientes, você deve instalar a CLI do Azure. | Instalar a CLI do Azure |
| Como faço para executar a CLI do Azure em um contêiner do Docker? | docker run -it mcr.microsoft.com/azure-cli |
Como executar a CLI do Azure em um contêiner do Docker |
| De quais URLs eu preciso para o bypass de proxy? | Isso depende da nuvem que você está usando. Para obter uma lista completa, confira a lista de pontos de extremidade necessários para o bypass de proxy. | Pontos de extremidade da CLI do Azure para bypass de proxy |
| Como me conecto? | Use az login dentro da janela do console. Use seu próprio nome de usuário e senha do Azure, uma entidade de serviço, identidade gerenciada ou WAM. |
Entrar com a CLI do Azure |
Usando comandos de referência
| Pergunta | Resposta | Saiba mais |
|---|---|---|
| O que é o padrão de sintaxe da CLI do Azure? | "command group + command subgroup + command + --parameters" Exemplo: "az storage accountcreate --name myStorageAccount" | Componentes da sintaxe da CLI do Azure. |
| Qual é a diferença entre um grupo de comandos, cmdlet, comando, alias, módulo e referência? | Boa pergunta! A CLI do Azure tem apenas grupos de comandos, comandos de referência e aliases definidos pelo usuário. Talvez você esteja pensando no Azure PowerShell ao procurar cmdlets e módulos. | Componentes da sintaxe da CLI do Azure. |
| O que é uma extensão e por que ela precisa ser instalada separadamente? | Extensões são suplementos de grupo de comandos que não são enviados como parte da CLI do Azure principal. Você será solicitado a instalar uma extensão na primeira vez que a usar. Obtenha uma lista de extensões disponíveis executando az extension list-available -output table. |
Usar e gerenciar extensões com a CLI do Azure |
| Como fazer obter uma lista de todos os comandos, núcleo e extensão? | Para obter uma lista de grupos de comandos, em seu console, digite az e pressione Enter. Para obter uma lista de subgrupos e comandos, use o parâmetro --help. Exemplo: az account --help ou az account subscription --help gera uma lista de comandos apenas para o grupo ou subgrupo. |
Índice de referência de A a Z |
| A CLI do Azure tem a conclusão da guia? | Sim! Ao digitar um comando no PowerShell, pressione a tecla Tab . Esse recurso só está disponível no PowerShell. | Habilitar o preenchimento de tabulação no PowerShell |
| Como faço para obter ajuda online? | Cada comando tem um parâmetro --help que resulta em descrições e dicas a serem exibidas no console. Por exemplo: az account ---help ou az vm create --help |
Você também pode Solicitar suporte. |
| Como posso aprender a usar vários comandos de referência para concluir um único trabalho a ser feito? | Estamos felizes por você ter perguntado! A CLI do Azure fornece vários comandos interativos que fornecem sintaxe e próximas etapas. Na próxima seção, saiba mais sobre az interactive, az scenario, az next e az find. |
Aprender sobre a CLI do Azure |
Para obter uma comparação lado a lado da sintaxe da CLI do Azure e do Azure PowerShell, confira CLI do Azure versus Azure PowerShell: Comparação de comandos lado a lado.
Confira comparações de script entre Bash, PowerShell e Cmd em Como consultar a saída do comando da CLI do Azure usando uma consulta JMESPath.
Aprender sobre a CLI do Azure
O tutorial Saiba como usar a CLI do Azure mostra como realizar diversas tarefas comuns da CLI do Azure com exemplos no Bash, PowerShell e Cmd. Aqui estão algumas das habilidades abordadas ao trabalhar com o Armazenamento do Azure:
- Decidir qual ambiente devo usar
- Localizar e alterar minha assinatura padrão
- Criar um recurso do Azure que contém uma ID aleatória no nome
- Configurar variáveis de ambiente
- Conhecer as diferenças de sintaxe entre Bash, PowerShell e Cmd
- Depurar comandos de referência da CLI do Azure
- Obter propriedades de um arquivo JSON local
- Excluir vários recursos usando um script
Também há vários comandos de referência que fornecem prompts interativos para ajudar você a aprender a CLI do Azure.
| Comando | Descrição | Exemplo |
|---|---|---|
| az interactive | Em um console do PowerShell, obtenha preenchimento automático, descrições de comando e exemplos conforme você digita. | Confira Trabalhar no modo interativo para obter mais informações. Exemplo: digite az interactive na janela do console e pressione Enter. |
| az scenario | Obtenha exemplos de E2E (ponta a ponta) e execute-os com prompts passo a passo. | Digite az scenario guide "keywords of interest" no console e, em seguida, pressione Enter. A CLI do Azure retorna cenários com base em suas palavras-chave. Exemplo: az scenario guide "virtual machines" |
| az next | Obtenha recomendações para o próximo comando da CLI do Azure com base nos padrões de execução do cliente. Você será solicitado a selecionar um caminho de comando. | Digite az next no console e, em seguida, pressione Enter. Escolha um dos 7 caminhos de comando predefinidos. |
| az find | Este é um robô de IA que retornará exemplos de referência para palavras-chave. | Digite az find "active subscription" no console e, em seguida, pressione Enter. |
Outra ótima maneira de aprender a usar a CLI do Azure é por meio dos Módulos do Microsoft Learn para ferramentas da CLI. Quando o módulo fornecer um ambiente de área restrita, use a área restrita para experimentar novos comandos sem incorrer em custos.
Perguntas comuns de uso
| Pergunta | Resposta de comando de referência | Saiba mais |
|---|---|---|
| Como sei qual assinatura estou usando? | az account show --output table |
Como gerenciar as assinaturas do Azure com a CLI do Azure |
| Como faço para alterar minha assinatura? | az account set --subscription "mySubscriptionName" |
Como gerenciar as assinaturas do Azure com a CLI do Azure |
| Como posso definir um grupo de recursos e local padrão? | az config set defaults.location=westus2 defaults.group=MyResourceGroup |
Definir configurações usando az config |
| Como faço para consultar a saída do comando? | az account show --query "{tenantId:tenantId,subscriptionid:id}" |
Confira Como consultar a saída do comando da CLI do Azure usando uma consulta JMESPath para obter muitos exemplos --query no Bash, PowerShell e Cmd. |
| Como faço para formatar a saída de um comando? | az account list --output table |
Formatos de saída dos comandos da CLI do Azure |
| Você pode me ajudar a aprender o Bash com os comandos da CLI do Azure? | Claro que não! Todos nós temos diferentes habilidades técnicas e, por esse motivo, a Microsoft oferece um guia de instruções para aprender o Bash. Aproveite! | Aprender a usar o Bash com a CLI do Azure |