Alterações interruptivas, cadência de versão e controle de versão do Azure PowerShell

  • Artigo

O módulo Az PowerShell é um módulo de pacote cumulativo de atualizações que contém mais de 70 módulos de serviço estáveis ou em GA (em disponibilidade geral) para gerenciar recursos do Azure diretamente no PowerShell.

Controle de versão

Os módulos Az PowerShell seguem o Controle de versão semântico para a numeração de versão. As versões dos módulos de serviço do Azure se enquadram em uma das três categorias:

  • Em 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 preliminar. 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.

Há dois módulos de rollup 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 AzPreview sempre tem a mesma versão e é liberado ao mesmo tempo que o módulo Az.

Cadência de versão

As atualizações planejadas para o módulo Az PowerShell são lançadas na primeira terça-feira de cada mês. Essas 12 atualizações planejadas por ano civil são divididas em duas categorias:

  • Versões principais. No máximo duas por ano civil, que introduzem alterações interruptivas. O primeiro número no número de versão é atualizado. Por exemplo, a versão 6.6.0 passa para a versão 7.0.0.
  • Versões secundárias. Dez por ano civil, que não introduzem alterações interruptivas. O segundo número no número de versão é atualizado. Por exemplo, a versão 7.0.0 passa para a versão 7.1.0.

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.

Versões de patch não planejadas podem ser liberadas a qualquer momento para corrigir bugs. As versões de patch não introduzem alterações interruptivas. O terceiro número no número de versão é atualizado. Por exemplo, a versão 6.2.0 passa para a versão 6.2.1.

Alterações de quebra

Importante

Alterações interruptivas podem ocorrer em qualquer momento nos módulos de versão prévia e versão prévia de recursos que não sejam GA. Módulos que não são de GA não precisam atender às políticas de alteração interruptiva.

Quando ocorrem alterações interruptivas

Lançamos duas versões com alterações interruptivas por ano:

  • Uma em maio/junho
  • Uma entre setembro e dezembro

Para obter informações sobre as próximas versões de alterações interruptivas, confira Marcos do Azure PowerShell.

Tipos de alterações da falha

Vários tipos de alterações interruptivas podem ocorrer em cmdlets. Para saber mais, confira Definição de alteração interruptiva.

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.

Mensagens de aviso de alteração interruptiva

As mensagens de aviso de alteração interruptiva são uma forma do autor do cmdlet do Azure PowerShell comunicar 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 interruptiva, confira Como desabilitar as mensagens de aviso de alteração interruptiva no Azure PowerShell?.

Para obter mais informações, confira Ajuda do atributo de alterações interruptivas.

Fornecer comentários

Outros recursos