The Azure Automation PowerShell ISE add-on makes it easy to author and test your runbooks in your local PowerShell ISE.
Note: This project is currently in development. Please open issues found or provide feedback in the feedback section of the add-on.
- Use Automation activities (Get-AutomationVariable, Get-AutomationPSCredential, etc) in local PowerShell Workflows and scripts
- Create and edit Automation assets locally
- Easily track local changes to runbooks and assets vs the state of these items in an Azure Automation account
- Sync runbook / asset changes between a local runbook authoring environment and an Azure Automation account
- Test PowerShell workflows and scripts locally in the ISE and in the automation service
To install from the PowerShell Gallery:
- Open the PowerShell console
- Run
Install-Module AzureAutomationAuthoringToolkit -Scope CurrentUser
If you want the PowerShell ISE to always automatically load the Azure Automation ISE add-on:
- Run
Install-AzureAutomationIseAddOn
If not:
- Any time you want to use the Azure Automation ISE add-on in the PowerShell ISE, run
Import-Module AzureAutomationAuthoringToolkit
in the PowerShell ISE
Follow the instructions for our latest release
To build from source:
- Download or clone this repository, and extract from zip if necessary
- Open AutomationISE/AutomationISE.sln in Visual Studio
- Build the solution. NuGet will pull the required packages.
- Put the resulting binaries in the AzureAutomationAuthoringToolkit/ISEaddon directory
- Place the AzureAutomationAuthoringToolkit folder somewhere in your PSModulePath, ex:
C:\Users\<USERNAME>\Documents\WindowsPowerShell\Modules
If you want the PowerShell ISE to always automatically load the Azure Automation ISE add-on:
- Open the PowerShell ISE, and run
Install-AzureAutomationIseAddOn
- The Azure Automation ISE add-on should appear on the right side of the PowerShell ISE: If not:
- Any time you want to use the Azure Automation ISE add-on in the PowerShell ISE, run
Import-Module AzureAutomationAuthoringToolkit
in the PowerShell ISE
- Open the PowerShell console
- Run
Uninstall-AzureAutomationIseAddOn
- Run
Uninstall-Module AzureAutomationAuthoringToolkit
- If the PowerShell ISE was open, reopen it
- From now on, opening the PowerShell ISE will no longer cause the Azure Automation ISE add-on to be loaded
- The
AzureAutomationAuthoringToolkit
cmdlets are currently incompatible with SMA'sEmulatedAutomationActivities
module due to name conflicts - The
AzureAutomationAuthoringToolkit
cmdlets may not run correctly on a SMA runbook worker or Automation Hybrid runbook worker due to name conflicts