Atualizar módulos Azure PowerShell em Automation

Este artigo descreve como atualizar módulos do Azure PowerShell (Az) no Automatização do Azure. O módulo Az PowerShell é um conjunto de cmdlets para gerenciar recursos do Azure diretamente do PowerShell. O Automatização do Azure fornece módulos PowerShell comuns por defeito em cada conta de Automação. Para mais informações, veja Módulos Padrão. À medida que a equipa do Azure atualiza regularmente os módulos do Azure, podem ocorrer alterações com os cmdlets incluídos. Por exemplo, renomear um parâmetro ou desvalorizar completamente um cmdlet. Estas alterações podem afetar runbooks e processos de automação existentes se os módulos não forem atualizados adequadamente. Para ajudar a gerir estas atualizações, o Automatização do Azure disponibiliza dois métodos para atualizar os módulos do Az :

• Atualize os módulos do Az através do portal Azure
• Atualize os módulos do Az através de um runbook

Configurar uma conta de automação

Para evitar afetar seus runbooks e os processos que eles automatizam, certifique-se de testar e validar à medida que faz atualizações. Se você não tiver uma conta de automação dedicada destinada a essa finalidade, considere criar uma para que você possa testar muitos cenários diferentes durante o desenvolvimento de seus runbooks. Esse teste deve incluir alterações iterativas, como a atualização dos módulos do PowerShell.

Verifique se sua conta de automação adicionou uma identidade gerenciada atribuída ao sistema ou uma identidade gerenciada atribuída pelo usuário.

Se você desenvolver seus scripts localmente, é recomendável ter as mesmas versões de módulo localmente que você tem em sua conta de automação ao testar para garantir que você receba os mesmos resultados. Depois de validados os resultados e aplicares as alterações necessárias, podes passar as alterações para produção.

Atualizar módulos Az

As secções seguintes explicam como podes atualizar os módulos do Az através do portal (recomendado) ou através do runbook.

Atualize os módulos do Az através do portal Azure

Atualmente, a atualização dos módulos do Arizona só está disponível através do portal. Atualizações através do PowerShell e do modelo do ARM estarão disponíveis no futuro. Apenas os módulos do Az predefinidos serão atualizados ao executar os seguintes passos:

1. Inicie sessão no portal do Azure e aceda à sua conta do Automation.

2. Em Recursos Partilhados, selecione Módulos.

3. Selecione Atualizar módulos do Az.

4. Selecione Módulo a Atualizar. Por predefinição, mostra o módulo Az.

5. Na lista suspensa, selecione Versão do Módulo e Versão de Execução.

6. Selecione Atualizar para atualizar o módulo Az para a versão que selecionou. Na página Módulos, você pode visualizar a lista conforme mostrado abaixo:

   

Se selecionar uma versão inferior à versão do módulo do Az existente importada na conta de Automatização, a operação de atualização efetuará uma reversão para a versão inferior selecionada.

Pode verificar a operação de atualização ao verificar a versão do módulo e a propriedade de estado dos módulos atualizados apresentados na lista de módulos em módulos do PowerShell.

A equipa do Azure atualiza regularmente a versão do módulo e oferece uma opção para atualizar os módulos padrão do Az selecionando a versão do módulo na lista suspensa.

Atualizar módulos Az através de runbook

Para atualizar os módulos do Azure na sua conta de Automação:

1. Utilize o runbook Update-AutomationAzureModulesForAccount, disponível como código aberto.
2. Descarregue do repositório GitHub para começar a usar este runbook e atualizar os seus módulos do Azure.
3. Importe-o para sua conta de automação ou execute-o como um script. Para saber como importar um runbook em sua conta de automação, consulte Importar um runbook.

O runbook Update-AutomationAzureModulesForAccount suporta a atualização dos módulos Azure, AzureRM e Az por padrão. Consulte o runbook dos módulos Update Azure README para mais informações sobre a atualização do Az. Módulos de automação com este runbook. Há outros fatores importantes que deve ter em conta ao utilizar os módulos Az na sua conta de Automatização. Para saber mais, consulte Gerenciar módulos em Automatização do Azure.

Use o código do runbook de atualização como um script regular do PowerShell

Você pode usar o código runbook como um script regular do PowerShell em vez de um runbook. Para isso, inicia sessão no Azure usando primeiro o cmdlet Connect-AzAccount e depois passa -Login $false para o script.

Utilize o guia operacional de atualização nas nuvens soberanas

Para usar este runbook em nuvens soberanas, use o parâmetro AzEnvironment para passar o ambiente correto para o runbook. Valores aceitáveis são AzureCloud (Azure public cloud), AzureChinaCloud, AzureGermanCloud e AzureUSGovernment. Pode recuperar estes valores usando Get-AzEnvironment | select Name. Se você não passar um valor para esse cmdlet, o runbook assumirá como padrão o AzureCloud.

Use o runbook de atualização para atualizar uma versão específica do módulo

Se quiseres usar uma versão específica do módulo Azure PowerShell em vez do módulo mais recente disponível no Galeria do PowerShell, passa essas versões para o parâmetro opcional ModuleVersionOverrides do runbook Update-AutomationAzureModulesForAccount. Para exemplos, veja o livro de operações Update-AutomationAzureModulesForAccount.ps1. Os módulos do Azure PowerShell que não são mencionados no parâmetro ModuleVersionOverrides são atualizados com as versões mais recentes dos módulos na Galeria do PowerShell. Se não passar nada para o parâmetro ModuleVersionOverrides, todos os módulos são atualizados para as versões mais recentes dos módulos na Galeria do PowerShell. Este comportamento é o mesmo para o botão Update Azure Modules no portal Azure.

Próximos passos

• Para detalhes sobre o uso de módulos, consulte Gerir módulos no Automatização do Azure.
• Para obter informações sobre o runbook de atualização, consulte o runbook de atualização dos módulos do Azure.
• Para resolver problemas ao atualizar módulos Azure PowerShell geridos como recursos partilhados em Automatização do Azure, veja Troubleshoot Automatização do Azure shared resource issues.