Como atualizar módulos do Azure PowerShell na Automação do AzureHow to update Azure PowerShell modules in Azure Automation

Para atualizar os módulos do Azure em sua conta de automação, você precisa usar o Azure atualizar módulos runbook, que está disponível como código-fonte aberto.To update the Azure modules in your Automation Account you need to use the Update Azure modules runbook, which is available as open source. Para começar a usar o runbook Update-AutomationAzureModulesForAccount para atualizar os módulos do Azure, baixe-o do repositório de runbooks de atualização de módulos do Azure no GitHub.To start using the Update-AutomationAzureModulesForAccount runbook to update your Azure modules, download it from the Update Azure modules runbook repository on GitHub. Em seguida, você pode importá-lo para sua conta de Automação ou executá-lo como um script.You can then import it into your Automation Account or run it as a script. Para saber como importar um runbook na sua conta de automação, consulte importar um runbook.To learn how to import a runbook in your Automation Account, see Import a runbook.

Os módulos do AzureRM PowerShell mais comuns são fornecidos por padrão em cada conta de automação.The most common AzureRM PowerShell modules are provided by default in each Automation account. A equipe do Azure atualiza os módulos do Azure regularmente, portanto mantenha atualizado você desejará usar o AutomationAzureModulesForAccount atualização runbook para atualizar os módulos em suas contas de automação.The Azure team updates the Azure modules regularly, therefore to keep up to date you will want to use the Update-AutomationAzureModulesForAccount runbook to update the modules in your Automation accounts.

Como os módulos são atualizados regularmente pelo grupo de produtos, as alterações podem ocorrer com os cmdlets incluídos.Because modules are updated regularly by the product group, changes can occur with the included cmdlets. Essa ação pode afetar negativamente seus runbooks dependendo do tipo de alteração, como renomear um parâmetro ou descontinuar um cmdlet inteiramente.This action may negatively impact your runbooks depending on the type of change, such as renaming a parameter or deprecating a cmdlet entirely.

Para evitar o impacto nos runbooks e nos processos que eles automatizam, teste e valide antes de continuar.To avoid impacting your runbooks and the processes they automate, test and validate before proceeding. 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.If you don't have a dedicated Automation account intended for this purpose, consider creating one so that you can test many different scenarios during the development of your runbooks. Esse teste deve incluir alterações iterativas, como atualizar os módulos do PowerShell.This testing should include iterative changes such as updating the PowerShell modules.

Se você desenvolve seus scripts localmente, é recomendável ter as mesmas versões do módulo localmente que você tem em sua Conta de Automação quando os testes para garantir que você receberá os mesmos resultados.If you develop your scripts locally, it's recommended to have the same module versions locally that you have in your Automation Account when testing to ensure you'll receive the same results. 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.After the results are validated and you've applied any changes required, you can move the changes to production.

Observação

Uma nova conta de Automação pode não conter os últimos módulos.A new Automation account might not contain the latest modules.

ConsideraçõesConsiderations

A seguir estão algumas considerações que se deve fazer ao usar esse processo para atualizar seus módulos do Azure:The following are some considerations to take into account when using this process to update your Azure Modules:

  • Esse runbook dá suporte à atualização apenas o Azure e AzureRm módulos no momento.This runbook supports updating only the Azure and AzureRm modules currently. Módulos do Azure do PowerShell Az têm suporte em contas de automação, mas não pode ser atualizada com este runbook.Azure PowerShell Az modules are supported in Automation accounts, but cannot be updated with this runbook. Há fatores importantes que você precisa levar em conta ao usar o Az módulos em sua conta de automação, para saber mais, consulte módulos de Az usando em sua conta de automação.There are important factors that you need to take into account when using the Az modules in your Automation Account, to learn more, see Using Az modules in your Automation Account.

  • Evite iniciar esse runbook em contas de Automação que contêm módulos Az.Avoid starting this runbook on Automation accounts that contain Az modules.

  • Antes de iniciar esse runbook, verifique se sua conta de Automação tem uma credencial da conta Executar como do Azure criada.Before starting this runbook, make sure your Automation account has an Azure Run As account credential created.

  • Você pode usar esse código como um script do PowerShell regular, em vez de um runbook: basta entrar no Azure usando o Connect-AzureRmAccount comando pela primeira vez, em seguida, passar -Login $false ao script.You can use this code as a regular PowerShell script instead of a runbook: just sign in to Azure using the Connect-AzureRmAccount command first, then pass -Login $false to the script.

  • Para usar esse runbook em nuvens soberanas, use o parâmetro AzureRmEnvironment para passar o ambiente correto para o runbook.To use this runbook on the sovereign clouds, use the AzureRmEnvironment parameter to pass the correct environment to the runbook. Os valores aceitáveis são AzureCloud, AzureChinaCloud, AzureGermanCloud e AzureUSGovernment.Acceptable values are AzureCloud, AzureChinaCloud, AzureGermanCloud, and AzureUSGovernment. Esses valores podem ser recuperados usando Get-AzureRmEnvironment | select Name.These values can be retrieved from using Get-AzureRmEnvironment | select Name. Se você não passar um valor para esse parâmetro, o padrão do runbook será a nuvem pública do Azure AzureCloudIf you don't pass a value to this parameter, the runbook will default to the Azure public cloud AzureCloud

  • Se você desejar usar uma versão específica do módulo Azure PowerShell, em vez da versão mais recente disponível na Galeria do PowerShell, passe essas versões para o parâmetro ModuleVersionOverrides opcional do runbook Update-AutomationAzureModulesForAccount.If you want to use a specific Azure PowerShell module version instead of the latest available on the PowerShell Gallery, pass these versions to the optional ModuleVersionOverrides parameter of the Update-AutomationAzureModulesForAccount runbook. Para obter exemplos, confira o runbook Update-AutomationAzureModulesForAccount.ps1.For examples, see the Update-AutomationAzureModulesForAccount.ps1 runbook. Os módulos do Azure PowerShell não mencionados no parâmetro ModuleVersionOverrides são atualizados com as versões mais recentes do módulo na Galeria do PowerShell.Azure PowerShell modules that aren't mentioned in the ModuleVersionOverrides parameter are updated with the latest module versions on the PowerShell Gallery. Se você não passar nada para o ModuleVersionOverrides parâmetro, todos os módulos são atualizados com as versões mais recentes do módulo na Galeria do PowerShell.If you pass nothing to the ModuleVersionOverrides parameter, all modules are updated with the latest module versions on the PowerShell Gallery. Esse comportamento é igual ao botão Atualizar Módulos do Azure.This behavior is the same as the Update Azure Modules button.

Problemas conhecidosKnown issues

Há um problema conhecido com os módulos do AzureRM em uma conta de automação que está em um grupo de recursos com um nome numérico que começa com 0 de atualização.There is a known issue with updating the AzureRM modules in an Automation Account that is in a resource group with a numeric name that starts with 0. Para atualizar os módulos do Azure em sua conta de automação, ele deve ser em um grupo de recursos que tem um nome alfanumérico.To update your Azure modules in your Automation Account, it must be in a resource group that has an alphanumeric name. Grupos de recursos com nomes numéricos, começando com 0 são não é possível atualizar os módulos AzureRM neste momento.Resource groups with numeric names starting with 0 are unable to update AzureRM modules at this time.

Próximas etapasNext steps

Visite o runbook de atualização de módulos do Azure de software livre para saber mais sobre ele.Visit the open source Update Azure modules runbook to learn more about it.