{"id":6062,"date":"2017-07-18T17:27:32","date_gmt":"2017-07-19T00:27:32","guid":{"rendered":"http:\/\/tommymaynard.com\/?p=6062"},"modified":"2022-08-13T13:27:48","modified_gmt":"2022-08-13T20:27:48","slug":"aws-userdata-multiple-run-framework-2017","status":"publish","type":"post","link":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/","title":{"rendered":"AWS UserData Multiple Run Framework"},"content":{"rendered":"

In AWS, we can utilize the UserData section in EC2 to run PowerShell against our EC2 instances at launch. I’ve said it before; I love this option. As someone that speaks PowerShell with what likely amounts to first language fluency, there’s so much I do to automate my machine builds with CloudFormation, UserData, and PowerShell.<\/p>\n

I’ve begun to have a need to do various pieces of automation at different times. This is to say I need to have multiple instance restarts, as an instance is coming online, in order to separate different pieces of configuration and installation. You’ll figure out when you need that, too. And, when you do, you can use what I’ve dubbed the “multiple run framework for AWS.” But really, you call it what you want. That hardly matters.<\/p>\n

We have to remember, that by default, UserData only runs once. It’s when the EC2 instance launches for the first time. In the below example, we’re going to do three restarts and four separate code runs.<\/p>\n

Our UserData section first needs to add a function to memory. I’ve called it Set-SystemForNextRun<\/code> and its purpose is to (1) create what I call a “passfile” to help indicate where we are in the automation process, (2) enable UserData to run the next time the service is restarted (this happens at instance restart, obviously), and (3) restart the EC2 instance. Let’s have a look. Its three parameters and three If<\/code> statements; simple stuff.<\/p>\n

\r\nFunction Set-SystemForNextRun {\r\n    Param (\r\n        [string]$PassFile,\r\n        [switch]$UserData,\r\n        [switch]$Restart\r\n    )\r\n    If ($PassFile) {\r\n        [System.Void](New-Item -Path "$env:SystemDrive\\passfile$PassFile.txt" -ItemType File)\r\n    }\r\n    If ($UserData) {\r\n        $Path = "$env:ProgramFiles\\Amazon\\Ec2ConfigService\\Settings\\config.xml"\r\n        [xml]$ConfigXml = Get-Content -Path $Path\r\n        ($ConfigXml.Ec2ConfigurationSettings.Plugins.Plugin |\r\n            Where-Object -Property Name -eq 'Ec2HandleUserData').State = 'Enabled'\r\n        $ConfigXml.Save($Path)\r\n    }\r\n    If ($Restart) {\r\n        Restart-Computer -Force\r\n    }\r\n}\r\n<\/pre>\n
The above function accepts three parameters: PassFile<\/strong>, UserData<\/strong>, and Restart<\/strong>. PassFile<\/strong> accepts a string value. You’ll see how this works in the upcoming If-ElseIf<\/code> example. UserData<\/strong> and Restart<\/strong> are switch parameters. If they’re included when the function is invoked, they’re True ($true<\/code>), and if they’re not included, they’re False ($false<\/code>).<\/p>\n
Each of the three parameters has its own If<\/code> statement within the Set-SystemforNextRun<\/code> function. If PassFile<\/strong> is included, it creates a text file called C:\\passfile<ValuePassedIn>.txt<\/code>. If UserData<\/strong> is included, it resets UserData to enabled (it effectively, checks the check box in the Ec2Config GUI). If Restart<\/strong> is included, it restarts the instance, right then and there.<\/p>\n
Now let’s take a look at the If-ElseIf<\/code> statement that completes four code runs and three restarts. We’ll discuss it further below, but before we do, a little reminder. Our CloudFormation UserData PowerShell is going to contain the above Set-SystemForNextRun<\/code> function, and something like you’ll see below after you’ve edited it for your needs.<\/p>\n
\r\nIf (-Not(Test-Path -Path "$env:SystemDrive\\passfile1.txt")) {\r\n\r\n    # Place code here (1).\r\n\r\n    # Invoke Set-SystemForNextRun function.\r\n    Set-SystemForNextRun -PassFile '1' -UserData -Restart\r\n\r\n} ElseIf (-Not(Test-Path -Path "$env:SystemDrive\\passfile2.txt")) {\r\n\r\n    # Place code here (2).\r\n\r\n    # Invoke Set-SystemForNextRun function.\r\n    Set-SystemForNextRun -PassFile '2' -UserData -Restart\r\n\r\n} ElseIf (-Not(Test-Path -Path "$env:SystemDrive\\passfile3.txt")) {\r\n\r\n    # Place code here (3).\r\n\r\n    # Invoke Set-SystemForNextRun function.\r\n    Set-SystemForNextRun -PassFile '3' -UserData -Restart\r\n\r\n} ElseIf (-Not(Test-Path -Path "$env:SystemDrive\\passfile4.txt")) {\r\n\r\n    # Place code here (4).\r\n\r\n    # Invoke Set-SystemForNextRun function.\r\n    Set-SystemForNextRun -PassFile '4'\r\n\r\n}\r\n<\/pre>\n
In line 1, we test whether or not the file C:\\passfile1.txt<\/code> exists. If it doesn’t exist, we run the code in the If<\/code> portion. This will run whatever PowerShell we add to that section. Then it’ll pass 1 to the Set-SystemForNextRun<\/code> function to have C:\\passfile01.txt<\/code> created. Additionally, because the UserData<\/strong> and Restart<\/strong> parameters are included, it’ll reset UserData to enabled, and restart the EC2 instance. Because the C:\\passfile1.txt<\/code> file now exists, the next time the UserData runs, it’ll skip the If<\/code> portion and evaluate the first ElseIf<\/code> statement.<\/p>\n
This ElseIf<\/code> statement determines whether or not the C:\\passfile2<\/strong>.txt<\/code> file exists, or not. If it doesn’t, and it won’t after the first restart, then the code in this ElseIf<\/code> will run. When it’s done, it’ll create the passfile2.txt<\/code> file, reset UserData, and restart the instance. It’ll do this for the second ElseIf<\/code> (third code run), and the final ElseIf<\/code> (fourth code run), as well. Notice that the final invocation of the Set-SystemForNextRun<\/code> function doesn’t enable UserData or Restart the instance. Be sure to add those if you need either completed after the final ElseIf<\/code> completes.<\/p>\n
And that’s it. At this point in time, I always use my Set-SystemForNextRun<\/code> function and a properly written If-ElseIf<\/code> statement to separate the configuration and installation around the necessary amount of instance restarts. In closing, keep in mind that deleting those pass files from the root of the C:\\<\/code> drive is not<\/strong> something you’ll likely want to do. In time, I may do a rewrite that stores entries in the Registry perhaps, so there’s less probability that one of these files might be removed by someone.<\/p>\n
Either way, I hope this is helpful for someone! If you’re in this space—AWS, CloudFormation, UserData, and PowerShell—then chances are good that at some point you’re going to want to restart an instance, and then continue to configure it.<\/p>\n
Read II<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
In AWS, we can utilize the UserData section in EC2 to run PowerShell against our EC2 instances at launch. I’ve said it before; I love this option. As someone that speaks PowerShell with what likely amounts to first language fluency, there’s so much I do to automate my machine builds with CloudFormation, UserData, and PowerShell. […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[420,2],"tags":[388,464,379,483,465],"class_list":["post-6062","post","type-post","status-publish","format-standard","hentry","category-aws","category-quick-learn","tag-aws","tag-cloudformation","tag-if-elseif","tag-set-systemfornextrun","tag-userdata"],"yoast_head":"\nAWS UserData Multiple Run Framework - tommymaynard.com<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AWS UserData Multiple Run Framework - tommymaynard.com\" \/>\n<meta property=\"og:description\" content=\"In AWS, we can utilize the UserData section in EC2 to run PowerShell against our EC2 instances at launch. I’ve said it before; I love this option. As someone that speaks PowerShell with what likely amounts to first language fluency, there’s so much I do to automate my machine builds with CloudFormation, UserData, and PowerShell. […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\" \/>\n<meta property=\"og:site_name\" content=\"tommymaynard.com\" \/>\n<meta property=\"article:published_time\" content=\"2017-07-19T00:27:32+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-08-13T20:27:48+00:00\" \/>\n<meta name=\"author\" content=\"Tommy Maynard\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Tommy Maynard\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\"},\"author\":{\"name\":\"Tommy Maynard\",\"@id\":\"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8\"},\"headline\":\"AWS UserData Multiple Run Framework\",\"datePublished\":\"2017-07-19T00:27:32+00:00\",\"dateModified\":\"2022-08-13T20:27:48+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\"},\"wordCount\":862,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8\"},\"keywords\":[\"AWS\",\"CloudFormation\",\"If-ElseIf\",\"Set-SystemForNextRun\",\"UserData\"],\"articleSection\":[\"AWS\",\"Quick Learn\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\",\"url\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\",\"name\":\"AWS UserData Multiple Run Framework - tommymaynard.com\",\"isPartOf\":{\"@id\":\"https:\/\/tommymaynard.com\/#website\"},\"datePublished\":\"2017-07-19T00:27:32+00:00\",\"dateModified\":\"2022-08-13T20:27:48+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/tommymaynard.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AWS UserData Multiple Run Framework\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/tommymaynard.com\/#website\",\"url\":\"https:\/\/tommymaynard.com\/\",\"name\":\"tommymaynard.com\",\"description\":\"A PowerShell Resource. Since June 2014.\",\"publisher\":{\"@id\":\"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/tommymaynard.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8\",\"name\":\"Tommy Maynard\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g\",\"caption\":\"Tommy Maynard\"},\"logo\":{\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g\"},\"description\":\"Windows PowerShell enthusiast with over 15 years of Information Technology experience.\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AWS UserData Multiple Run Framework - tommymaynard.com","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/","og_locale":"en_US","og_type":"article","og_title":"AWS UserData Multiple Run Framework - tommymaynard.com","og_description":"In AWS, we can utilize the UserData section in EC2 to run PowerShell against our EC2 instances at launch. I’ve said it before; I love this option. As someone that speaks PowerShell with what likely amounts to first language fluency, there’s so much I do to automate my machine builds with CloudFormation, UserData, and PowerShell. […]","og_url":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/","og_site_name":"tommymaynard.com","article_published_time":"2017-07-19T00:27:32+00:00","article_modified_time":"2022-08-13T20:27:48+00:00","author":"Tommy Maynard","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Tommy Maynard","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#article","isPartOf":{"@id":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/"},"author":{"name":"Tommy Maynard","@id":"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8"},"headline":"AWS UserData Multiple Run Framework","datePublished":"2017-07-19T00:27:32+00:00","dateModified":"2022-08-13T20:27:48+00:00","mainEntityOfPage":{"@id":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/"},"wordCount":862,"commentCount":0,"publisher":{"@id":"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8"},"keywords":["AWS","CloudFormation","If-ElseIf","Set-SystemForNextRun","UserData"],"articleSection":["AWS","Quick Learn"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/","url":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/","name":"AWS UserData Multiple Run Framework - tommymaynard.com","isPartOf":{"@id":"https:\/\/tommymaynard.com\/#website"},"datePublished":"2017-07-19T00:27:32+00:00","dateModified":"2022-08-13T20:27:48+00:00","breadcrumb":{"@id":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/tommymaynard.com\/aws-userdata-multiple-run-framework-2017\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/tommymaynard.com\/"},{"@type":"ListItem","position":2,"name":"AWS UserData Multiple Run Framework"}]},{"@type":"WebSite","@id":"https:\/\/tommymaynard.com\/#website","url":"https:\/\/tommymaynard.com\/","name":"tommymaynard.com","description":"A PowerShell Resource. Since June 2014.","publisher":{"@id":"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/tommymaynard.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/tommymaynard.com\/#\/schema\/person\/c74505a44d3d93dc7f82a08502d81ff8","name":"Tommy Maynard","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g","caption":"Tommy Maynard"},"logo":{"@id":"https:\/\/secure.gravatar.com\/avatar\/ff5e885ce365c2b895df63b9b0d98a7f1a1d1421def6bfb59336a95460fc2329?s=96&d=mm&r=g"},"description":"Windows PowerShell enthusiast with over 15 years of Information Technology experience."}]}},"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p8mce3-1zM","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/posts\/6062","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/comments?post=6062"}],"version-history":[{"count":6,"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/posts\/6062\/revisions"}],"predecessor-version":[{"id":13031,"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/posts\/6062\/revisions\/13031"}],"wp:attachment":[{"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/media?parent=6062"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/categories?post=6062"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tommymaynard.com\/wp-json\/wp\/v2\/tags?post=6062"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}