Octopus Deploy Documentation

Configuring the version of the Azure PowerShell Modules

Last updated

A version of Azure PowerShell is bundled with Octopus Deploy.  To determine the versions of the various Azure modules, add the PowerShell below to an Azure PowerShell Script Step:

Azure Module Versions

Get-Module -ListAvailable -Name Azure*

If you wish to use a different version, you can install the Azure PowerShell modules on your Octopus Server, and configure Octopus to use the installed version.  The procedure to configure this differs depending on which version of Octopus Deploy you are using:

Octopus 2020.1 or newer

The PowerShell Azure step has an option called "Azure Tools". Toggle the setting to Use Azure Tools pre-installed on the worker.

Octopus 2018.5.5 to 2019.13.7

We made this configurable by variables in Octopus 2018.5.5 to be more flexible. Create a variable named OctopusUseBundledAzureModules and set its value to False.

With this value set, Octopus Deploy will not load the bundled Azure PowerShell modules, and PowerShell will automatically load the Azure modules installed on the Octopus Server.

Now Octopus will attempt to load these modules when executing an Azure step, rather than the version bundled with Octopus.

Learn more

Need support? We're here to help.