Atualizar módulos Azure PowerShell na Automação

Os módulos mais comuns do PowerShell são fornecidos por padrão em cada conta de Automação. Consulte Módulos padrão. À medida que a equipe de Azure atualiza os módulos Azure regularmente, as alterações podem ocorrer com os cmdlets incluídos. Essas alterações, por exemplo, renomear um parâmetro ou descontinuar totalmente um cmdlet, podem afetar negativamente seus runbooks.

Configurar uma conta de Automação

Para evitar impactar os runbooks e os processos que eles automatizam, teste e valide à medida que faz atualizações. Se você não tiver uma conta de Automação dedicada destinada para essa finalidade, considere criar uma para que você possa testar vários cenários e permutações diferentes durante o desenvolvimento de seus runbooks. Esse teste deve incluir alterações iterativas, como atualizar os módulos do PowerShell.

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

Se você desenvolve seus scripts localmente, é recomendável ter localmente as mesmas versões do módulo que você tem em sua conta de Automação durante os testes para garantir que você receberá os mesmos resultados. Depois que os resultados forem validados e você tiver aplicado as alterações necessárias, você pode mover as alterações para a produção.

Atualizar módulos Az

As seções a seguir explicam como você pode atualizar os módulos do Az por meio do portal (recomendado) ou por meio do runbook.

Atualizar módulos do Az por meio do portal

Atualmente, a atualização dos módulos AZ está disponível apenas no Portal. Atualizações por meio do PowerShell e do modelo ARM estarão disponíveis no futuro. Somente os módulos AZ padrão serão atualizados ao executar as seguintes etapas:

1. Entre no portal Azure e navegue até sua conta de Automação.

2. Em Recursos Compartilhados, selecione Módulos.

3. Selecione Atualizar módulos Az.

4. Selecione Módulo para Atualizar. Por padrão, ele mostrará o Módulo Az.

5. No menu suspenso, selecione Versão do Módulo e Versão do Runtype

6. Escolha Atualizar para atualizar o módulo Az para a versão que você selecionou. Na página Módulos, você pode ver a lista, desta forma:

   

Se você selecionar uma versão inferior à versão do módulo AZ existente importada na conta de automação, a operação de atualização executará uma reversão para a versão inferior selecionada.

Você pode conferir a operação de atualização verificando a versão do módulo e a propriedade de Status dos módulos atualizados mostradas na lista de módulos em Módulos do PowerShell.

A equipe de Azure atualizará regularmente a versão do módulo e fornecerá uma opção para atualizar os módulos default Az selecionando a versão do módulo na lista suspensa.

Atualizar módulos do Az por meio do runbook

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

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

O runbook Update-AutomationAzureModulesForAccount dá suporte à atualização dos módulos Azure, AzureRM e Az por padrão. Revise o README do runbook de atualização dos módulos do Azure Update Azure para obter mais informações sobre como atualizar o Az. Módulos de automação com esse runbook. Há outros fatores importantes que você precisa levar em conta ao usar os módulos Az em sua conta de Automação. Para saber mais, consulte Gerenciar módulos no Automação do Azure.

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

É possível usar o código do runbook como um script regular do PowerShell em vez de um runbook. Para fazer isso, entre no Azure usando o cmdlet Connect-AzAccount primeiro e passe -Login $false para o script.

Usar o runbook de atualização em nuvens soberanas

Para usar esse runbook em nuvens soberanas, use o parâmetro AzEnvironment para transmitir o ambiente correto para o runbook. Os valores aceitáveis são AzureCloud (Azure nuvem pública), AzureChinaCloud, AzureGermanCloud e AzureUSGovernment. Esses valores podem ser recuperados usando Get-AzEnvironment | select Name. Se você não passar um valor para esse cmdlet, o runbook será padronizado como AzureCloud.

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

Se você quiser usar uma versão específica do módulo Azure PowerShell em vez do módulo mais recente disponível no Galeria do PowerShell, passe essas versões para o parâmetro opcional ModuleVersionOverrides do runbook Update-AutomationAzureModulesForAccount. Para obter exemplos, consulte o runbook Update-AutomationAzureModulesForAccount.ps1. Módulos do Azure PowerShell que não são mencionados no parâmetro ModuleVersionOverrides são atualizados para as versões mais recentes no Galeria do PowerShell. Se você não passar nada para o parâmetro ModuleVersionOverrides, todos os módulos serão atualizados com as versões mais recentes do módulo no Galeria do PowerShell. Esse comportamento é o mesmo para o botão Update Azure Modules no portal do Azure.

Próximas etapas

• Para obter detalhes sobre como usar módulos, consulte Manage modules in Automação do Azure.
• Para obter informações sobre o runbook de atualização, consulte Update Azure modules runbook.
• Para solucionar problemas ao atualizar módulos Azure PowerShell gerenciados como recursos compartilhados no Automação do Azure, consulte Troubleshoot Automação do Azure problemas de recursos compartilhados.