An Azure Automation runbook that updates Azure modules imported into an Azure Automation account with module versions available on the PowerShell Gallery.
Branch: master
Clone or download
AnatoliB Add README content (#2)
* Add Purpose section

* Add Usage section

* Add Notes section

* Remove "/en-us" from doc links
Latest commit d306c82 Jan 24, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Tests Copy the runbook from the internal repository (#1) Jan 23, 2019
LICENSE Initial commit Jan 2, 2019
README.md Add README content (#2) Jan 24, 2019
Update-AutomationAzureModulesForAccount.ps1 Copy the runbook from the internal repository (#1) Jan 23, 2019

README.md

Updating Azure PowerShell modules in Azure Automation accounts

Purpose

This Azure Automation runbook updates Azure PowerShell modules imported into an Azure Automation account with the module versions published to the PowerShell Gallery. See How to update Azure PowerShell modules in Azure Automation for more details.

Usage

Import this runbook into your Automation account, and start it as a regular Automation runbook.

Notes

  • If you import this runbook with the original name (Update-AutomationAzureModulesForAccount), it will override the internal runbook with this name. As a result, the imported runbook will run when the Update Azure Modules button is pushed or when this runbook is invoked directly via ARM API for this Automation account. If this is not what you want, specify a different name when importing this runbook.
  • Only Azure and AzureRM.* modules are currently supported. The new Azure PowerShell Az modules are not supported yet. Avoid starting this runbook on Automation accounts that contain Az modules.
  • Before starting this runbook, make sure your Automation account has an Azure Run As account credential created.
  • You can use this code as a regular PowerShell script instead of a runbook: just login to Azure using the Connect-AzureRmAccount command first, then pass -Login $false to the script.
  • To use this runbook on the sovereign clouds, provide the appropriate value to the AzureEnvironment parameter. Please also make sure you read the compatibility notes.
  • When facing compatibility issues, you may want to use specific older module versions instead of the latest available on the PowerShell Gallery. In this case, provide the required versions in the ModuleVersionOverrides parameter.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.