Apresentação do módulo Az do Azure PowerShell

Descrição Geral

O módulo Az do PowerShell é um conjunto de cmdlets para gerir recursos do Azure diretamente do PowerShell. O PowerShell fornece funcionalidades poderosas para automatização que podem ser alavancadas para gerir os seus recursos Azure, por exemplo, no contexto de um pipeline CI/CD.

O módulo Az do PowerShell é a substituição do AzureRM e é a versão recomendada a utilizar para interagir com o Azure.

Importante

Como os módulos Az PowerShell têm agora todas as capacidades dos módulos AzureRM PowerShell e muito mais, vamos retirar os módulos AzureRM PowerShell no dia 29 de fevereiro de 2024.

Para evitar interrupções de serviço, atualize os scripts que utilizam módulos AzureRM PowerShell para utilizar módulos Az PowerShell até 29 de fevereiro de 2024. Para atualizar automaticamente os seus scripts, siga o guia de arranque rápido.

Pode utilizar o módulo Az do PowerShell com um dos seguintes métodos:

Funcionalidades

O módulo Az do PowerShell inclui as seguintes vantagens:

  • Segurança e estabilidade
    • Encriptação de cache de token
    • Prevenção do tipo de ataque "man-in-the-middle"
    • Suporte da autenticação com o ADFS 2019
    • Autenticação por nome de utilizador e palavra-passe no PowerShell 7
    • Suporte para funcionalidades como avaliação de acesso contínuo
  • Suporte para todos os serviços do Azure
    • Todos os serviços do Azure em disponibilidade geral têm um módulo do PowerShell suportado correspondente
    • Várias correções de erros e atualizações da versão da API desde o AzureRM
  • Novas funcionalidades
    • Suporta no Cloud Shell e multiplataformas
    • Pode obter e utilizar o token de acesso para aceder a recursos do Azure
    • Cmdlet disponível para operações REST avançadas com recursos do Azure

Nota

PowerShell 7.0.6 LTS, PowerShell 7.1.3 ou superior é a versão recomendada do PowerShell para utilização com o módulo Azure Az PowerShell em todas as plataformas.

O módulo Az do PowerShell baseia-se na biblioteca .NET Standard e funciona com o PowerShell 7 e posteriores em todas as plataformas, incluindo Windows, macOS e Linux. Também é compatível com o Windows PowerShell 5.1.

Estamos comprometidos em levar o suporte do Azure a todas as plataformas e todos os módulos Az do PowerShell são multiplataformas.

Atualizar o seu ambiente para o Az

Para se manter a par das mais recentes funcionalidades do Azure no PowerShell, deve migrar para o módulo Az. Se não estiver pronto para instalar o módulo Az como substituto do AzureRM, tem algumas opções disponíveis para experimentar o Az:

  • Utilize um ambiente PowerShell com o Azure Cloud Shell. O Azure Cloud Shell é um ambiente de shell baseado no browser que é fornecido com o módulo do Az instalado e com os aliases de compatibilidade Enable-AzureRM ativados.
  • Mantenha o módulo AzureRM instalado no Windows PowerShell 5.1 e instale o módulo Az no PowerShell 7 ou posteriores. O Windows PowerShell 5.1 e o PowerShell 7 e posteriores utilizam coleções de módulos diferentes. 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 a partir de uma instalação existente do AzureRM:

  1. Desinstalar o módulo do Azure PowerShell AzureRM
  2. Instalar o módulo do Azure PowerShell Az
  3. OPCIONAL: Ative o modo de compatibilidade para adicionar aliases para cmdlets do AzureRM com Enable-AzureRMAlias enquanto se familiariza com o novo conjunto de comandos. Para obter mais informações, veja a próxima secção ou Iniciar a migração do AzureRM para o Az.

Migrar scripts existentes do AzureRM para o Az

Se os seus scripts ainda tiverem por base o módulo AzureRM, temos vários recursos que o ajudam com a migração:

Suportabilidade

O Az é o módulo do PowerShell mais atual para o Azure. É possível registar problemas ou pedidos de funcionalidades diretamente no repositório do GitHub ou, se tiver um contrato de suporte, através do suporte da Microsoft. Os pedidos de funcionalidades serão implementados na última versão do Az. Os problemas críticos serão implementados nas duas últimas versões do Az.

Como os módulos Az PowerShell têm agora todas as capacidades dos módulos AzureRM PowerShell e muito mais, vamos retirar os módulos AzureRM PowerShell no dia 29 de fevereiro de 2024.

Para evitar interrupções de serviço, atualize os scripts que utilizam módulos AzureRM PowerShell para utilizar módulos Az PowerShell até 29 de fevereiro de 2024. Para atualizar automaticamente os seus scripts, siga o guia de arranque rápido.

Recolha de dados

O Azure PowerShell recolhe dados telemétricos por predefinição. A Microsoft agrega os 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 pessoais ou privados. Por exemplo, os dados de utilização ajudam a identificar problemas, como cmdlets com pouco sucesso, e a priorizar o seu trabalho.

Embora consideremos útil receber estes dados, também compreendemos que nem todas as pessoas pretendem enviar os dados de utilização. Pode desativar a recolha de dados com o cmdlet Disable-AzDataCollection. Também pode ser a nossa declaração de privacidade para saber mais.