Atualizar módulos Azure PowerShell em Automation

Os módulos do PowerShell mais comuns são fornecidos por predefinição em cada conta de Automatização. Consulte 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. Estas alterações, como por exemplo, mudar o nome de um parâmetro ou preterir completamente um cmdlet, podem afetar negativamente os seus runbooks.

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 que os resultados forem validados e você tiver aplicado as alterações necessárias, poderá movê-las para a produção.

Atualizar módulos Az

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

Atualizar módulos do Az através do portal

Atualmente, a atualização dos módulos do AZ 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 Azure e aceda à sua conta de Automação.

2. Em Recursos Partilhados, selecione Módulos.

3. Selecione Atualizar módulos do Az.

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

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

6. Selecione Atualizar para atualizar o módulo do 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 Azure atualizará regularmente a versão do módulo e fornecerá uma opção para atualizar os módulos Az default 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 usar os módulos Az na sua conta de Automaçã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. Esses valores podem ser recuperados 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 a utilização de módulos, consulte Gerenciar módulos em 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.