Collections of Automation resources that can include runbooks, configurations, modules, credentials, schedules, variables, connections, certificates, jobs, compilation jobs, and nodes.
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
000-base-automation-resource-templates fixing bug in string variable templates Nov 11, 2015
101-get-vm-tutorial Updating packs to follow new conventions Nov 1, 2015
101-import-and-start-job upating default parameters Aug 2, 2018
101-remove-resourcegroups update permanent URI location Aug 8, 2016
101-sample-automation-resource-templates Updating module url to use permalink Apr 29, 2016
101-sample-using-base-automation-templates Updating packs to follow new conventions Nov 1, 2015
101-sample-using-single-automation-template Updating packs to follow new conventions Nov 1, 2015
102-sample-automation-setup Update deployThroughARM.ps1 Jun 21, 2016
200-connect-azure-vm Updating packs to follow new conventions Nov 1, 2015
200-copy-file-to-azure-vm Updating packs to follow new conventions Nov 1, 2015
201-Deploy-And-Compile-DSC-Configuration-Credentials Merge pull request #14 from memoryz/patch-2 Jul 18, 2016
201-Deploy-And-Compile-DSC-Configuration-using-base-templates Fix configurationURI in file azuredeploy.json - https://raw.githubuse… Nov 25, 2015
201-Deploy-And-Compile-DSC-Configuration base templates: Sep 9, 2015
201-deploy-dsc-resources-and-configuration base templates: Sep 9, 2015
201-start-azure-vm-graphical-base-templates fixing bug in string variable templates Nov 11, 2015
201-start-azure-vm-graphical Updating packs to follow new conventions Nov 1, 2015
201-stop-azure-vm-graphical Updating packs to follow new conventions Nov 1, 2015
deploy-vm-with-dsc-configuration Update to readme.md. Jul 9, 2018
managed-vm Make hybrid worker unique to each VM Aug 30, 2018
onboardSolution Create onboardautomationsolutions.json Nov 6, 2017
LICENSE Starter Automation pack, readme, and license Jun 15, 2015
README.md Update README.md Nov 26, 2015

README.md

Automation Packs

Automation Packs include an Azure Resource Manager template that deploys Automation resources to Azure. The template can include any Automation resource needed for an Automation solution. Automation resources include:

  • Runbooks
  • DSC Configurations
  • DSC Configuration Compilation Jobs
  • Runbook jobs
  • Integration Modules
  • Schedules
  • Credentials
  • Certificates
  • Variables
  • Connections

##Rules for contributing to the Automation repository

  1. Each Automation pack is contained in its own folder.

  2. The parent deployment template must be named azuredeploy.json. You can also have child templates which do not need to follow a naming convention.

  3. Include a Readme.md file that explains: 4. How the template works and what the Automation pack automates 5. What resources are deployed 6. Includes the "Deploy to Azure" link 7. Any known limitations

  4. Any Automation assets used in your runbooks or DSC configurations should be included in the deployment template.

  5. Any runbooks, modules, or DSC Configurations in your ARM template should use the following conventions:

  6.  1. A **variable** containing the **URL** for the resource content
     2. A **variable** containing the **Name** of the resource
    
  7. Any Automation assets in your template should follow the the following conventions:

  8.  1. **Parameter(s)** for the asset value(s) are in the deployment template to allow end users input their own values
     2.  A **variable** for each asset name 	
    
  9. Template parameters should:

    1. Follow camelCasing
    2. Contain allowedValues wherever it makes sense
    3. Have the description specified using the metadata property. An example is included below:
"automationAccountName": {
      "type": "string",
      "metadata": {
          "description": "The name of the Automation Account"
      }
}

##Recommendations for writing your Automation Pack

Runbooks in Automation Packs

You can store runbooks referenced in Automation Packs in two different ways:

  1. In an external location of your choice. Preferred locations are the PowerShell Gallery or Script Center
  2. In a Runbook subfolder within the Automation Pack.

Best practices for runbooks:

  1. Follow practices outlined here.
  2. Always include a header with the following when publishing to PowerShell Gallery:
	<#PSScriptInfo
    
	    .Version 1.0
	    .Author elcooper
	    .CompanyName Microsoft Corporation
	    .Copyright (c) 2015 Microsoft Corporation. All rights reserved.
	    .Tags Tag1 Tag2
	    .LicenseUri https://contoso.com/License
	    .ProjectUri https://contoso.com/
	    .IconUri https://contoso.com/MyScriptIcon
	    .ExternalModuleDependencies bar
	    .RequiredScripts foo 
	    
	    .ReleaseNotes 
	         contoso script now supports following features
	         Feature 1
	         Feature 2
	         Feature 3
	         
	#>

PowerShell Modules in Automation Packs

You can store modules used in your runbook in two different ways:

  1. Create a Module subfolder and place all your modules in the folder.
  2. Place your modules on the PowerShell GitHub repository and publish your module to PowerShell Gallery.

To deploy a module, you must also have a zipped module folder formatted for Azure Automation. This is used in the Azure Resource Manager deployment template. For more on creating modules for Azure Automation see Authoring Integration Modules.

Follow the PowerShell best practices for publishing a module to the PowerShell gallery outlined in this blog.

Other notes on authoring Automation Packs

If you have a pack that contains many Automation resources, you can write one parent template that refers to the base templates: 000-base-templates. This allows you to reuse the core Automation resource templates without having to write your own.