Developing Azure Automation Runbooks–using correct modules

When developing Runbooks for Azure Automation I noticed that it’s important to use the same (Global) PowerShell Module versions as available as Asset in Azure Automation. But let’s first talk about Azure  Automation Assets a bit more.

Automation Assets

Automation Assets are various resources that are globally available to be used in or associated with a Runbook. Assets include Schedules, Modules, Certificates, Connections, Variables and Credentials.

For more information about the Automation Assets check the following Automation Documentation page: https://azure.microsoft.com/en-us/documentation/services/automation/

Modules

If look at the Modules Asset we see some default available Global modules and some Integration Modules. The Global Modules have been updated automatically by the Automation Service.
You cannot remove Global Modules.

If we retrieve some more details from one of the Global Modules (example. AzureRM.Storage) we get the following info.

So why would you care about this info?

If you are like me, you always want to use the latest and greatest tools as soon as they are available. This is also true for my PowerShell Modules. I regularly check the PowerShell Gallery for the latest available PowerShell Modules.

Let’s check what the latest available version of the AzureRM.Storage Module is on the PowerShell Gallery.

Code Snippet

1. Find-Module -name AzureRM.Storage

Result:

 

So what does this tell us? On the PowerShell Gallery there is a newer version of the AzureRM.Storage Module available. If you use this latest version in one of the Azure Automation Runbooks you are developing it could fail when using the Global AzureRM.Storage module on Azure Automation.

That’s why I was looking for a way to retrieve the Global Module versions being used in Azure Automation and download those modules from the PowerShell Gallery when developing and testing my Runbooks locally.

Let see the script in Action first.

Here is the script I used to download the same Global Modules used in Azure Automation locally.  After Saving you still need to install these modules in your PSModulePath Environment variable folders.

Code Snippet

1. #requires -Version 3 -Modules PowerShellGet

2.  

3. # ---------------------------------------------------

4. # Script: C:\Users\stefstr\OneDrive - Microsoft\Scripts\PS\Azure\Automation\ShowAzureAutomationModulesInfo.ps1

5. # Version: 0.1

6. # Author: Stefan Stranger

7. # Date: 06/15/2016 09:15:31

8. # Description: Show Azure Automation Module Info and Download the same Modules as used in Azure Automation

9. # Comments:

10. # Changes:  

11. # Disclaimer:

12. # This example is provided "AS IS" with no warranty expressed or implied. Run at your own risk.

13. # **Always test in your lab first**  Do this at your own risk!!

14. # The author will not be held responsible for any damage you incur when making these changes!

15. # ---------------------------------------------------

16.  

17. #Login to Azure

18. Add-AzureRmAccount

20. #Select Azure Subscription

21. $subscription =

22. (Get-AzureRmSubscription |

23.     Out-GridView `

24.     -Title 'Select an Azure Subscription ...' `

25. -PassThru)

27. Set-AzureRmContext -SubscriptionId $subscription.subscriptionId -TenantId $subscription.TenantID

30. #Select ResourceGroup

31. $ResourceGroup = Get-AzureRmResourceGroup | Out-GridView -PassThru

32.  

33. #Select AutomationAccount

34. $AutomationAccountName = Get-AzureRmAutomationAccount -ResourceGroupName $ResourceGroup.ResourceGroupName | Out-GridView -PassThru

36. #Retrieve all used Azure Modules within Azure Automation

37. $ModulesOutput = Get-AzureRmAutomationModule -ResourceGroupName $ResourceGroup.ResourceGroupName -AutomationAccountName $AutomationAccountName.AutomationAccountName | Where-Object -FilterScript {

38. $_.Name -like '*Azure*'

39. }

40.  

41. $endresult = @()

42. foreach ($Module in $ModulesOutput)

43. {

44.      $Module = Get-AzureRmAutomationModule -Name $Module.Name -ResourceGroupName $ResourceGroup.ResourceGroupName -AutomationAccountName $AutomationAccountName.AutomationAccountName

45.      $obj = New-Object -TypeName PSObject

46.      $obj | Add-Member -MemberType NoteProperty -Name ModuleName -Value $($Module.name)

47.      $obj | Add-Member -MemberType NoteProperty -Name IsGlobal -Value $($Module.IsGlobal)

48.      $obj | Add-Member -MemberType NoteProperty -Name Version -Value $($Module.version)     

49.      $obj | Add-Member -MemberType NoteProperty -Name SizeInBytes -Value $($Module.SizeInBytes)

50.      $obj | Add-Member -MemberType NoteProperty -Name CreationTime -Value $($Module.CreationTime)

51.      $obj | Add-Member -MemberType NoteProperty -Name LastModifiedTime -Value $($Module.LastModifiedTime)

52.      $obj = $obj | Add-Member -MemberType NoteProperty -Name ProvisioningState -Value $($Module.ProvisioningState) -PassThru

53.      $endresult = $endresult + $obj

54. }

55.  

56. $endresult

57.  

58. #Check if modules can downloaded from PSGallery

59. $psgallery = @()

60. foreach ($azuremodule in $endresult)

61. {

62.     $psgallerymodule = Find-Module -Name $azuremodule.ModuleName -MaximumVersion $azuremodule.version -ErrorAction SilentlyContinue

63.     $obj = New-Object -TypeName PSObject

64.     $obj | Add-Member -MemberType NoteProperty -Name Version -Value $($psgallerymodule.Version)

65.     $obj | Add-Member -MemberType NoteProperty -Name Name -Value $($psgallerymodule.Name)

66.     $obj | Add-Member -MemberType NoteProperty -Name Type -Value $($psgallerymodule.Type)

67.     $obj | Add-Member -MemberType NoteProperty -Name Repository -Value $($psgallerymodule.Repository)

68.     $obj = $obj | Add-Member -MemberType NoteProperty -Name Description -Value $($psgallerymodule.Description) -PassThru

69.     $psgallery = $psgallery + $obj

70. }

71.  

72. #Select Modules you want to download from PSGallery

73. $psgallery |

74. Out-GridView -Title 'Select Module to save' -OutputMode Multiple |

75. ForEach-Object -Process {

76. Save-Module -Name $($_.name) -MaximumVersion $($_.version)  -Path $env:TEMP

77. }

Hope this helps.

Comments

• Anonymous
  January 29, 2017
  nice information