This script is intended to be run as a part of Update Management Pre/Post scripts.


It requires a RunAs account, the module "ThreadJobs" from the PowerShell Gallery, and the usage of the Turn On VMs script as a pre-deployment script.


This script will ensure all Azure VMs in the Update Deployment are turned off after they recieve updates.


This script reads the name of machines that were started by Update Management via the Turn On VMs script
#requires -Modules ThreadJob 
 Stop VMs that were started as part of an Update Management deployment 
  This script is intended to be run as a part of Update Management Pre/Post scripts.  
  It requires a RunAs account. 
  This script will turn off all Azure VMs that were started as part of TurnOnVMs.ps1. 
  It retrieves the list of VMs that were started from an Automation Account variable. 
.PARAMETER SoftwareUpdateConfigurationRunContext 
  This is a system variable which is automatically passed in by Update Management during a deployment. 
#region BoilerplateAuthentication 
#This requires a RunAs account 
$ServicePrincipalConnection = Get-AutomationConnection -Name 'AzureRunAsConnection' 
Add-AzureRmAccount ` 
    -ServicePrincipal ` 
    -TenantId $ServicePrincipalConnection.TenantId ` 
    -ApplicationId $ServicePrincipalConnection.ApplicationId ` 
    -CertificateThumbprint $ServicePrincipalConnection.CertificateThumbprint 
$AzureContext = Select-AzureRmSubscription -SubscriptionId $ServicePrincipalConnection.SubscriptionID 
#endregion BoilerplateAuthentication 
#If you wish to use the run context, it must be converted from JSON 
$context = ConvertFrom-Json  $SoftwareUpdateConfigurationRunContext 
$runId = "PrescriptContext" + $context.SoftwareUpdateConfigurationRunId 
#Retrieve the automation variable, which we named using the runID from our run context.  
$variable = Get-AutomationVariable -Name $runId 
if (!$variable)  
    Write-Output "No machines to turn off" 
# In order to prevent asking for an Automation Account name and the resource group of that AA, 
# search through all the automation accounts in the subscription  
# to find the one with a job which matches our job ID 
$AutomationResource = Get-AzureRmResource -ResourceType Microsoft.Automation/AutomationAccounts 
foreach ($Automation in $AutomationResource) 
    $Job = Get-AzureRmAutomationJob -ResourceGroupName $Automation.ResourceGroupName -AutomationAccountName $Automation.Name -Id $PSPrivateMetadata.JobId.Guid -ErrorAction SilentlyContinue 
    if (!([string]::IsNullOrEmpty($Job))) 
        $ResourceGroup = $Job.ResourceGroupName 
        $AutomationAccount = $Job.AutomationAccountName 
$vmIds = $variable -split "," 
$stoppableStates = "starting""running" 
$jobIDsNew-Object System.Collections.Generic.List[System.Object] 
#This script can run across subscriptions, so we need unique identifiers for each VMs 
#Azure VMs are expressed by: 
# subscription/$subscriptionID/resourcegroups/$resourceGroup/providers/microsoft.compute/virtualmachines/$name 
$vmIds | ForEach-Object { 
    $vmId =  $_ 
    $split = $vmId -split "/"; 
    $subscriptionId = $split[2];  
    $rg = $split[4]; 
    $name = $split[8]; 
    Write-Output ("Subscription Id: " + $subscriptionId) 
    $mute = Select-AzureRmSubscription -Subscription $subscriptionId 
    $vm = Get-AzureRmVM -ResourceGroupName $rg -Name $name -Status  
    $state = ($vm.Statuses[1].DisplayStatus -split " ")[1] 
    if($state -in $stoppableStates) { 
        Write-Output "Stopping '$($name)' ..." 
        $newJob = Start-ThreadJob -ScriptBlock { param($resource$vmname) Stop-AzureRmVM -ResourceGroupName $resource -Name $vmname -Force} -ArgumentList $rg,$name  
    }else { 
        Write-Output ($name + ": already stopped. State: " + $state)  
#Wait for all machines to finish stopping so we can include the results as part of the Update Deployment 
$jobsList = $jobIDs.ToArray() 
if ($jobsList) 
    Write-Output "Waiting for machines to finish stopping..." 
    Wait-Job -Id $jobsList 
foreach($id in $jobsList) 
    $job = Get-Job -Id $id 
    if ($job.Error) 
        Write-Output $job.Error 
#Clean up our variables: 
Remove-AzureRmAutomationVariable -AutomationAccountName $AutomationAccount -ResourceGroupName $ResourceGroup -name $runID