Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Descrição geral
O módulo Az PowerShell é um conjunto de cmdlets para gerir recursos do Azure diretamente a partir do PowerShell. O PowerShell oferece funcionalidades poderosas de automação que podem ser aproveitadas para gerir os seus recursos Azure, por exemplo, no contexto de um pipeline CI/CD.
O módulo Az PowerShell é o substituto do AzureRM e é o módulo recomendado para interagir com o Azure.
Advertência
O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Você pode usar o módulo Az PowerShell com um dos seguintes métodos:
- Instale o módulo Az PowerShell.
- Usa Azure Cloud Shell.
- Utilize o contentor Az PowerShell Docker.
Caraterísticas
O módulo Az PowerShell apresenta os seguintes benefícios:
- Segurança e estabilidade
- Criptografia de cache de token
- Prevenção de ataques do tipo man-in-the-middle
- Suporte à autenticação com o ADFS 2019
- Autenticação de nome de usuário e senha no PowerShell 7
- Suporte para recursos como avaliação de acesso contínuo
- Suporte para todos os serviços Azure
- Todos os serviços Azure geralmente disponíveis têm um módulo PowerShell suportado correspondente
- Várias correções de bugs e atualizações de versão da API desde o AzureRM
- Novas capacidades
- Suporte em Cloud Shell e multiplataforma
- É possível obter e usar o token de acesso para aceder a recursos do Azure
- Cmdlet disponível para operações REST avançadas com recursos do Azure
Observação
O PowerShell 7.2 ou superior é a versão recomendada do PowerShell para uso com o módulo Az PowerShell em todas as plataformas.
O módulo Az PowerShell baseia-se na biblioteca .NET Standard e funciona com PowerShell 7.2 e posteriores em todas as plataformas, incluindo Windows, Linux e macOS. Também é compatível com o PowerShell 5.1 do Windows.
Estamos comprometidos em levar o Azure support a todas as plataformas e todos os módulos do Az PowerShell são multiplataformas.
Atualize seu ambiente para Az
Para acompanhar as funcionalidades mais recentes do Azure no PowerShell, deve migrar para o módulo do Arizona. Se você não estiver pronto para instalar o módulo Az como um substituto para o AzureRM, você tem algumas opções disponíveis para experimentar o Az:
- Usa um ambiente
PowerShellcom Azure Cloud Shell. Azure Cloud Shell é um ambiente de shell baseado em browser que vem com o módulo Az instalado e os aliases de compatibilidadeEnable-AzureRMativados. - Mantenha o módulo AzureRM instalado no PowerShell 5.1 do Windows e instale o módulo Az no PowerShell 7 ou posterior. O Windows PowerShell 5.1 e o PowerShell 7 e posteriores usam coleções separadas de módulos. Siga as instruções para instalar a versão mais recente do PowerShell e, em seguida, instale o módulo Az a partir do PowerShell 7 ou posterior.
Para atualizar de uma instalação existente do AzureRM:
- Desinstalar o módulo Azure PowerShell AzureRM
- Instalar o módulo Az PowerShell
- OPCIONAL: habilite o modo de compatibilidade para adicionar aliases para cmdlets do AzureRM com Enable-AzureRMAlias enquanto você se familiariza com o novo conjunto de comandos. Para obter mais informações, consulte a próxima seção ou Iniciar migração do AzureRM para Az.
Migrar scripts existentes do AzureRM para Az
Se seus scripts ainda forem baseados no módulo AzureRM, temos vários recursos para ajudá-lo com a migração:
- Introdução à migração do AzureRM para Az
- Lista completa de alterações significativas do AzureRM para Az 1.0.0
- O cmdlet Enable-AzureRmAlias
Supportability
O Az é o módulo PowerShell mais atual para o Azure. Problemas ou pedidos de funcionalidades podem ser registados diretamente no repositório GitHub, ou através do suporte Microsoft se tiver um contrato de suporte. Os pedidos de funcionalidades são implementados na versão mais recente do Azure. Problemas críticos estão presentes nas duas últimas versões do Az.
Como os módulos do Az PowerShell agora têm todos os recursos dos módulos do AzureRM PowerShell e muito mais, substituímos os módulos do AzureRM PowerShell a partir de 29 de fevereiro de 2024.
Para evitar interrupções de serviço, atualize seus scripts que usam módulos do AzureRM PowerShell para usar módulos do Az PowerShell. Para atualizar automaticamente seus scripts, siga o guia de início rápido.
Recolha de dados
O Azure PowerShell recolhe dados de telemetria por defeito. A Microsoft agrega dados recolhidos para identificar padrões de utilização, identificar problemas comuns e melhorar a experiência do Azure PowerShell. O Microsoft Azure PowerShell não recolhe quaisquer dados privados ou pessoais. Por exemplo, os dados de uso ajudam a identificar problemas como cmdlets com baixo sucesso e ajudam a priorizar nosso trabalho.
Embora apreciemos os insights que esses dados fornecem, também entendemos que nem todos querem enviar dados de uso. Você pode desabilitar a coleta de dados com o cmdlet. Pode também ler a nossa declaração de privacidade para obter mais informações.
Azure PowerShell