Start-VMsInSequence.ps1
|
<#PSScriptInfo
.VERSION 1.1 .GUID 34e96a09-afde-43f9-bb8d-be50d0eafbae .AUTHOR info@thomas-zuehlke.de .COMPANYNAME .COPYRIGHT .TAGS AzureAutomation VirtualMachines Utility Start .LICENSEURI .PROJECTURI https://www.thomas-zuehlke.de/2020/01/start-stop-vms-in-sequence-and-with-delay-via-azure-automation/ .ICONURI .EXTERNALMODULEDEPENDENCIES Az.Account Az.Compute .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES #> #Requires -Module Az.Account #Requires -Module Az.Compute <# .SYNOPSIS Connects to Azure and starts specified VMs in a sequence and including a wait time between the VMs. .DESCRIPTION Connects to Azure and starts specified VMs in a sequence and including a wait time between the VMs. It is based on Start-AzureV2Vs (https://github.com/azureautomation/runbooks/blob/master/Utility/ARM/Start-AzureV2VMs.ps1). If you provide the sequence "vm1, vm2, 60, vm3, 30, vm4", then VM1 starts first, then VM2, then it waits 60 seconds before VM3 starts, then waits again for 30 seconds and finally VM4 starts. .PARAMETER AzureConnectionAssetName Optional with default of "AzureRunAsConnection". The name of an Automation connection asset that contains an Azure AD service principal with authorization for the subscription you want to start VMs in. To use an asset with a different name you can pass the asset name as a runbook input parameter or change the default value for this input parameter. .PARAMETER ResourceGroupName Mandatory All VMs in the sequence list, must be located in this resource group. .PARAMETER Sequence Mandatory A sequence of VM names of a resource group and waiting times in seconds. The informations are separated with commas. Example: vm1, vm2, 60, vm3 This starts vm1, then vm2, then waiting 1 minute and afterward will vm3 be started. .NOTES AUTHOR: Thomas Zühlke LASTEDIT: Januar, 2020 #> # Returns strings with status messages [OutputType([String])] param ( [Parameter(Mandatory=$false)] [String] $AzureConnectionAssetName = "AzureRunAsConnection", [Parameter(Mandatory=$true)] [String] $ResourceGroupName, [Parameter(Mandatory=$true)] [String] $Sequence ) try { # Connect to Azure using service principal auth $ServicePrincipalConnection = Get-AutomationConnection -Name $AzureConnectionAssetName Write-Output "Logging in to Azure..." $Null = Add-AzAccount ` -ServicePrincipal ` -TenantId $ServicePrincipalConnection.TenantId ` -ApplicationId $ServicePrincipalConnection.ApplicationId ` -CertificateThumbprint $ServicePrincipalConnection.CertificateThumbprint } catch { if(!$ServicePrincipalConnection) { throw "Connection $AzureConnectionAssetName not found." } else { throw $_.Exception } } $elems = $Sequence.Split(",") foreach($elem in $elems){ $elem = $elem.Trim() [int]$seconds = 0 [bool]$result = [int]::TryParse($elem, [ref]$seconds) if($result -eq $true) { Write-Output "Sleeping $seconds ..." Start-Sleep $seconds }else { Write-Host "Starting VM: $elem" $VM = Get-AzVM -ResourceGroupName $ResourceGroupName -Name $elem $StartRtn = $VM | Start-AzVM -ErrorAction Continue if ($StartRtn.Status -ne "Succeeded") { # The VM failed to start, so send notice Write-Output ($VM.Name + " failed to start") Write-Error ($VM.Name + " failed to start. Error was:") -ErrorAction Continue Write-Error (ConvertTo-Json $StartRtn) -ErrorAction Continue } else { # The VM started, so send notice Write-Output ($VM.Name + " has been started") } } } |