Folha de truques de integração da CLI do Azure
Se você está procurando integrar rapidamente com a CLI do Azure, veio 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
Vá direto para exemplos de comandos de referência, scripts de exemplo e tutoriais usando estes links:
- Encontre um índice de inícios rápidos, guias de instruções e tutoriais no índice de documentos da CLI do Azure de A a Z.
- Escolha um script testado e torne-o seu a partir do índice de exemplo da CLI do Azure de A a Z.
- Para obter um formato publicado de ajuda em linha, aceda ao índice de referência de A a Z.
- Vá para Microsoft Learn Modules for CLI tools para treinamento on-line gratuito com um ambiente sandbox.
Introdução
| Pergunta | Resposta | Saber 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. | Escolha a ferramenta de linha de comando certa |
| Onde posso executar a CLI do Azure? | A CLI do Azure é executada em contêineres do Windows (Cmd ou PowerShell), Linux, macOS, Docker e Azure Cloud Shell. Usar o Azure Cloud Shell é a maneira mais rápida de começar. | Executar o Azure Cloud Shell |
| Tenho de instalar a CLI do Azure? | O Azure Cloud Shell e algumas distribuições 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 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 que URLs necessito para o desvio de proxy? | Isso depende da nuvem que você está usando. Para obter uma lista completa, consulte 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 posso iniciar sessão? | 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 | Saber mais |
|---|---|---|
| Qual é o padrão de sintaxe da CLI do Azure? | "command group + command subgroup + command + --parameters" Exemplo: "az storage accountcreate --name myStorageAccount" | Componentes de 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 só tem grupos de comandos, comandos de referência e aliases definidos pelo usuário. Você pode estar pensando no Azure PowerShell se estiver procurando cmdlets e módulos. | Componentes de sintaxe da CLI do Azure. |
| O que é uma extensão e por que ela tem que ser instalada separadamente? | As extensões são suplementos do grupo de comandos que não são fornecidos como parte da CLI principal do Azure. Você será solicitado a instalar uma extensão na primeira vez que usá-la. 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 faço para obter uma lista de todos os comandos, tanto núcleo quanto extensão? | Para obter uma lista de grupos de comandos, no console, digite az e Enter. Para obter uma lista de subgrupos e comandos, use o --help parâmetro. Exemplo: az account --help ou gera uma lista de comandos apenas para o grupo ou az account subscription --help subgrupo. |
Índice de referência de A a Z |
| A CLI do Azure tem conclusão de guia? | Sim! Ao digitar um comando no PowerShell, pressione a tecla Tab . Esse recurso só está disponível no PowerShell. | Habilitar conclusão de guia no PowerShell |
| Como posso obter ajuda em linha? | Cada comando tem um --help parâmetro que resulta em descrições e dicas para exibir no console. 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 que você perguntou! A CLI do Azure fornece vários comandos interativos que fornecem sintaxe e as próximas etapas. Na próxima seção, saiba mais sobre az interactive, , , az scenarioaz nexte az find. |
Aprendendo a CLI do Azure |
Para obter uma comparação lado a lado da sintaxe da CLI do Azure e do Azure PowerShell, consulte CLI do Azure vs Azure PowerShell: comparação de comandos lado a lado.
Veja comparações de script entre Bash, PowerShell e Cmd em Como consultar a saída do comando CLI do Azure usando uma consulta JMESPath.
Aprendendo a CLI do Azure
O tutorial Aprenda a usar a CLI do Azure orienta você por muitas tarefas comuns da CLI do Azure com exemplos em Bash, PowerShell e Cmd. Aqui estão algumas das habilidades abordadas ao trabalhar com o Armazenamento do Azure:
- Decida qual ambiente devo usar
- Localizar e alterar a minha subscrição predefinida
- Criar um recurso do Azure contendo uma ID aleatória no nome
- Definir variáveis de ambiente
- Aprenda 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
Há também vários comandos de referência que fornecem prompts interativos para ajudá-lo a aprender a CLI do Azure.
| Comando | Description | Exemplo |
|---|---|---|
| az interativo | Em um console do PowerShell, obtenha preenchimento automático, descrições de comandos e exemplos à medida que digita. | Consulte Trabalhar no modo interativo para obter mais informações. Exemplo: Digite az interactive na janela do console e Enter. |
| Cenário AZ | Obtenha exemplos de ponta a ponta (E2E) e execute-os com prompts passo a passo. | Digite az scenario guide "keywords of interest" no console e Enter. A CLI do Azure retorna cenários com base na(s) sua(s) palavra(s)-chave. Exemplo: az scenario guide "virtual machines" |
| az seguinte | 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 Enter. Escolha entre 1 de 7 caminhos de comando predefinidos. |
| az encontrar | Este é um robô de IA que retornará exemplos de referência para palavras-chave. | Digite az find "active subscription" no console e Enter. |
Outra ótima maneira de aprender a usar a CLI do Azure é por meio das ferramentas Microsoft Learn Modules for CLI. Quando o módulo fornece um ambiente de área restrita, use a área restrita para tentar novos comandos sem incorrer em custos.
Perguntas comuns sobre o uso
| Pergunta | Resposta do comando de referência | Saber mais |
|---|---|---|
| Como sei que subscrição estou a utilizar? | az account show --output table |
Como gerenciar assinaturas do Azure com a CLI do Azure |
| Como posso alterar a minha subscrição? | az account set --subscription "mySubscriptionName" |
Como gerenciar assinaturas do Azure com a CLI do Azure |
| Como posso definir um grupo de recursos e uma localização predefinidos? | az config set defaults.location=westus2 defaults.group=MyResourceGroup |
Definir configurações usando az config |
| Como consultar a saída do comando? | az account show --query "{tenantId:tenantId,subscriptionid:id}" |
Consulte Como consultar a saída do comando CLI do Azure usando uma consulta JMESPath para obter muitos --query exemplos em Bash, PowerShell e Cmd. |
| Como formatar a saída de um comando? | az account list --output table |
Formatos de saída para comandos da CLI do Azure |
| Você pode me ajudar a aprender Bash com comandos da CLI do Azure? | Com certeza! Todos nós temos pontos fortes técnicos diferentes e, por esse motivo, a Microsoft oferece um guia de instruções para aprender Bash. Desfrute! | Aprenda a usar o Bash com a CLI do Azure |