Introdução ao Azure PowerShell

O Azure PowerShell foi projetado para gerenciar e administrar recursos do Azure na linha de comando. Use o Azure PowerShell quando quiser compilar ferramentas automatizadas que usam o modelo do Azure Resource Manager. Teste-o em seu navegador com o Azure Cloud Shell ou instale-o em seu computador local.

Este artigo ajuda você a começar a usar o Azure PowerShell, além de ensinar os conceitos básicos por trás dele.

Instalar ou executar no Azure Cloud Shell

A maneira mais fácil para começar a usar o Azure PowerShell é testando-o em um ambiente do Azure Cloud Shell. Para começar a usar o Cloud Shell, confira Início Rápido do PowerShell no Azure Cloud Shell. O Cloud Shell executa o PowerShell em um contêiner do Linux. Portanto, a funcionalidade específica do Windows não está disponível.

Quando você estiver pronto para instalar o Azure PowerShell em seu computador local, siga as instruções em Instalar o módulo do Azure PowerShell.

Entrar no Azure

Entre interativamente com o cmdlet Connect-AzAccount. Caso você use o Cloud Shell, pule esta etapa. Sua sessão do Azure Cloud Shell já está autenticada para o ambiente, a assinatura e o locatário que iniciaram a sessão do Cloud Shell.

Connect-AzAccount

Os serviços de nuvem do Azure oferecem ambientes que estão em conformidade com as leis de manipulação de dados regionais. Para contas em uma nuvem regional, use o parâmetro Environment para entrar. Obtenha o nome do ambiente de sua região usando o cmdlet Get-AzEnvironment. Por exemplo, para entrar no Azure China 21Vianet:

Connect-AzAccount -Environment AzureChinaCloud

Começando com o módulo do Az PowerShell versão 5.0.0, o Connect-AzAccount apresenta um prompt de logon interativo baseado em navegador por padrão. Você pode especificar o parâmetro UseDeviceAuthentication para receber uma cadeia de caracteres de token que anteriormente era o padrão para o PowerShell versão 6 e superior.

Depois de entrar, você verá informações indicando qual das suas assinaturas do Azure está ativa. Caso você tenha várias assinaturas do Azure em sua conta e queira selecionar uma diferente, obtenha suas assinaturas disponíveis com o Get-AzSubscription e use o cmdlet Set-AzContext com sua ID da assinatura. Para obter mais informações sobre como gerenciar suas assinaturas do Azure no Azure PowerShell, confira Usar várias assinaturas do Azure.

Depois de entrar, use os cmdlets do Azure PowerShell para acessar e gerenciar os recursos em sua assinatura. Para saber mais sobre o processo de entrada e os métodos de autenticação, confira Entrar com o Azure PowerShell.

Localizar comandos

Os cmdlets do Azure PowerShell seguem uma convenção de nomenclatura padrão para o PowerShell, Verb-Noun. O verbo descreve a ação (por exemplo, New, Get, Set, Remove) e o substantivo descreve o tipo de recurso (por exemplo, AzVM, AzKeyVaultCertificate, AzFirewall, AzVirtualNetworkGateway). Os substantivos no Azure PowerShell sempre começam com o prefixo Az. Para obter a lista completa de verbos padrão, confira Verbos aprovados para comandos do PowerShell.

Conhecer os substantivos, os verbos e os módulos disponíveis do Azure PowerShell ajuda a localizar comandos com o cmdlet Get-Command. Por exemplo, para localizar todos os comandos relacionados à VM que usam o verbo Get:

Get-Command -Verb Get -Noun AzVM* -Module Az.Compute

Para ajudar você a localizar os comandos comuns, esta tabela lista o tipo de recurso, o módulo correspondente do Azure PowerShell e o prefixo do substantivo para usar com Get-Command:

Tipo de recurso Módulo do Azure PowerShell Prefixo do substantivo
Grupo de recursos Az.Resources AzResourceGroup
Máquinas virtuais Az.Compute AzVM
Contas de armazenamento Az.Storage AzStorageAccount
Key Vault Az.KeyVault AzKeyVault
Aplicativos Web Az.Websites AzWebApp
Bancos de dados SQL Az.Sql AzSqlDatabase

Para obter uma lista completa dos módulos do Azure PowerShell, confira a lista de módulos do PowerShell do Azure hospedada no GitHub.

Coleta de dados

O Azure PowerShell coleta dados telemétricos por padrão. A Microsoft agrega dados coletados não só para identificar padrões de uso e problemas comuns, mas também para aprimorar a experiência do Azure PowerShell. O Microsoft Azure PowerShell não coleta dados privados ou pessoais. Por exemplo, os dados de uso ajudam a identificar problemas – como cmdlets com baixo índice de sucesso – e a priorizar o trabalho.

Embora apreciemos os insights fornecidos por esses dados, também entendemos que nem todos desejam enviar dados de uso. Você pode desabilitar a coleta de dados com o cmdlet Disable-AzDataCollection. Você também pode ler a nossa política de privacidade para saber mais.

Aprenda as noções básicas do Azure PowerShell com guias de início rápido e tutoriais

Para começar a usar o Azure PowerShell, teste um tutorial aprofundado para configurar máquinas virtuais e aprender como consultá-las.

Também há guias de início rápido do Azure PowerShell para outros serviços populares do Azure:

Próximas etapas