Ciclo de vida de suporte do Azure PowerShell
Todo produto da Microsoft tem um ciclo de vida. Ele começa quando o produto é lançado e termina quando ele não tem mais suporte. Conhecer datas importantes desse ciclo de vida ajuda você a tomar decisões informadas sobre quando atualizar ou fazer outras alterações no software.
O ciclo de vida de suporte do Azure PowerShell foi projetado para fornecer clareza e previsibilidade para os clientes em relação ao suporte para cada versão. O tempo e o grau de suporte variam com base em algumas qualificações. O ciclo de vida de suporte do Azure PowerShell segue a Política de Ciclo de Vida Moderna da Microsoft, a menos que especificado de outra forma neste artigo.
O “Azure PowerShell” consiste no módulo do PowerShell chamado “Az” e os módulos dependentes do PowerShell assinados pela “Microsoft Corporation”. Para obter a lista atual de módulos do Az PowerShell, confira Módulos do Azure PowerShell.
Controle de versão
O Azure PowerShell segue o Controle de Versão Semântico para numeração de versão. O controle de versão semântico é um sistema que usa um formato de número de três partes: major.minor.patch.
- Versões principais: alterações interruptivas, incluindo alterações de arquitetura e design fundamentais.
- Versões secundárias: atualizações de recursos compatíveis com versões anteriores e cobertura avançada dos serviços do Azure.
- Versões de patch: correções de segurança compatíveis com versões anteriores sem novos recursos ou alterações de funcionalidade.
Tipos de versão do módulo
As versões do Azure PowerShell podem incluir os seguintes tipos de versões:
- GA (disponibilidade geral): módulos versão 1.0.0 e superior sem versão prévia na versão. Adere à política de alteração interruptiva.
- Versão prévia: módulos abaixo da versão 1.0.0. Não adere à política de alteração interruptiva.
- Versão prévia do recurso: módulos versão 1.0.0 e superior com versão prévia na versão. Não adere à política de alteração interruptiva.
Cuidado
Versões prévias e de visualização de recursos não são recomendadas para ambientes de produção.
Há dois módulos do Az PowerShell:
- Az. Instala todos os módulos de serviço em GA para gerenciar recursos do Azure.
- AzPreview. Instala todos os módulos em GA e versão prévia para gerenciar recursos do Azure. Não inclui módulos de versão prévia de recurso.
O módulo AzPreviewsempre tem a mesma versão e é liberado ao mesmo tempo que o módulo Az.
Cadência de versão
O Azure PowerShell é atualizado mensalmente, com até duas versões anuais introduzindo alterações interruptivas. Essa cadência de lançamento foi projetada para fornecer aos clientes datas previsíveis de lançamento, capacitando empresas, desenvolvedores e a comunidade a tomar decisões estratégicas ao planejar seus roteiros.
Aviso
Antes de atualizar para uma versão de alteração interruptiva do módulo Az PowerShell, você deve examinar o guia de migração.
Suporte a versões
O Azure PowerShell fornece dois tipos de versões disponíveis em geral. Os clientes podem escolher versões do STS (Suporte a Prazo Padrão) ou do LTS (Suporte a Longo Prazo). A qualidade de todas as versões é a mesma. A única diferença é a duração do suporte.
Versões do Suporte a Termos Padrão (STS)
- Versões principais com numeração ímpar são versões do STS.
- Há suporte para versões do STS até a próxima versão principal do Azure PowerShell.
- Com suporte por aproximadamente seis meses a partir da data de lançamento da versão principal original.
- Recebe versões secundárias e atualizações de patch até ficar sem suporte.
Versões com LTS (suporte de longo prazo)
- As versões principais com numeração uniforme são versões LTS, começando pelo Az 12.0.0.
- A versão final de cada versão do LTS tem suporte até que a segunda versão subsequente do STS seja lançada.
- Com suporte por aproximadamente 18 meses a partir da data de lançamento da versão principal original.
- Recebe atualizações de versão secundárias apenas para os primeiros 6 meses e atualizações de patch até que não há suporte.
Importante
Instale a versão secundária e de patch mais recente para se qualificar para o suporte.
A imagem a seguir ilustra a cadência de versão e o ciclo de vida de suporte das versões do Azure PowerShell para STS e LTS.
A tabela a seguir fornece exemplos de como a cadência da versão se correlaciona com o ciclo de vida de suporte:
Observação
As datas na tabela a seguir são apenas para fins de exemplo. As datas de lançamento reais variam.
| Número da versão | Agenda de lançamentos | Alterações da falha | Tipo de Versão | Tipo de suporte | Com suporte até a versão |
|---|---|---|---|---|---|
| 12.0.0 | Maio de 2024 |  |
Principal | LTS | 12.1.0 |
| 12.1.0 | Junho de 2024 | Secundária | LTS | 12.2.0 | |
| 12.2.0 | Julho de 2024 | Secundária | LTS | 12.3.0 | |
| 12.3.0 | Agosto de 2024 | Secundária | LTS | 12.4.0 | |
| 12.4.0 | Setembro de 2024 | Secundária | LTS | 12.5.0 | |
| 12.5.0 | Outubro de 2024 | Secundária | LTS | 15.0.0 | |
| 13.0.0 | Novembro de 2024 | |
Principal | STS | 13.1.0 |
| 13.1.0 | Dezembro de 2024 | Secundária | STS | 13.2.0 | |
| 13.2.0 | Janeiro de 2025 | Secundária | STS | 13.3.0 | |
| 13.3.0 | Fevereiro de 2025 | Secundária | STS | 13.4.0 | |
| 13.4.0 | Março de 2025 | Secundária | STS | 13.5.0 | |
| 13.5.0 | Abril de 2025 | Secundária | STS | 14.0.0 | |
| 14.0.0 | Maio de 2025 | |
Principal | LTS | 14.1.0 |
- Exemplos:
- Para se qualificar para o suporte, atualize para 12.1.0 quando liberado se tiver o Az 12.0.0 instalado.
- Se o Az 12.5.0 for a versão final do Az versão 12, ele terá suporte até o lançamento do Az 15.0.0.
- Quando o Az 14.0.0 é lançado, o Az versão 13 não tem mais suporte.
Alterações da falha
As principais versões do Azure PowerShell introduzem alterações interruptivas e ocorrem até duas vezes por ano. Vários tipos de alterações interruptivas podem ocorrer em cmdlets. Para saber mais, confira Definição de alteração interruptiva. Alterações interruptivas podem ocorrer em qualquer momento nos módulos de versão prévia e versão prévia de recursos. Módulos que não são de GA não precisam atender às políticas de alteração interruptiva.
Mensagens de aviso de alteração interruptiva
As mensagens de aviso de alteração interruptiva são uma forma dos autores do cmdlet do Azure PowerShell comuniquem as próximas alterações interruptivas com os usuários finais.
Suprimir mensagens de aviso de alteração interruptiva
Para suprimir mensagens de aviso de alteração interruptivas, consulte Configurar mensagens de aviso de alteração interruptivas em configurações globais.
Para obter mais informações, confira Ajuda do atributo de alterações interruptivas.
Lista de alterações interruptivas
Para obter informações detalhadas sobre alterações interruptivas nas principais versões do módulo do Az PowerShell, confira os artigos a seguir.
- Alterações interruptivas futuras
- Alterações interruptivas do Az 12.0.0
- Alterações interruptivas do Az 11.0.0
- Alterações interruptivas do Az 10.0.0
- Alterações interruptivas do Az 9.0.1
- Alterações interruptivas do Az 8.0.0
- Alterações interruptivas do Az 7.0.0
- Alterações interruptivas do Az 6.0.0
- Alterações da falha do Az 5.0.0
- Alterações da falha do Az 4.1.0
- Alterações da falha do Az 3.0.0
- Alterações da falha do Az 2.0.0
Ambientes compatíveis
A tabela a seguir identifica as plataformas compatíveis com os módulos Az, AzureRM e Azure PowerShell.
| PowerShell do Azure | PowerShell <= 7.1 |
PowerShell >= 7.2 |
Windows PowerShell 5.1 |
|---|---|---|---|
| Az 12.x |
 |
|
|
| Az 11.x |
|
|
|
 <= Az 10.x |
|
|
|
| AzureRM 6.13.2 |
|
|
|
| Azure 5.3.1 |
|
|
|
- O ícone indica combinações de versão do Azure PowerShell e do PowerShell com suporte.
- O ícone indica combinações de versão do Azure PowerShell e do PowerShell que não têm mais suporte.
- O ícone indica combinações de versão do Azure PowerShell e do PowerShell sem suporte.