PowerShell script to vertically scale up and down or pause/resume an Azure Power BI Embedded Capacity according to a schedule. You can use this in an Azure Automation Runbook. Upgraded version for 2021 because all versions of the AzureRM PowerShell module are outdated. The Az PowerShell module is now the recommended PowerShell module for interac…

PowerBIEmbeddedScheduledAutoscaling.ps1

<#   
.SYNOPSIS  
    Vertically scale up and down or pause/resume an Azure Power BI Embedded Capacity according to a schedule using Azure Automation.    
   
.DESCRIPTION   
    This Azure Automation runbook enables vertically scaling or pausing of an Azure Power BI Embedded Capacity according to a schedule. Autoscaling based on a schedule allows you to scale your solution according to predictable resource demand. For example you could require a high capacity (e.g. A5) on monday during peak hours, while the rest of the week the traffic is decreased, allowing you to scale down (e.g. A1). Outside business hours and during weekends you could then suspend the capacity so no charges will be applied. This runbook can be scheduled to run hourly. The code checks the scalingSchedule parameter to decide if scaling needs to be executed, or if the capacity is in the desired state already and no work needs to be done. The script is time zone aware.

.PARAMETER resourceGroupName
    Name of the resource group to which the capacity is assigned.

.PARAMETER azureRunAsConnectionName
    Azure Automation Run As account name. Needs to be able to access
    the $capacityName.

.PARAMETER serverName  
    Azure Power BI Embedded Capacity name. 

.PARAMETER scalingSchedule
    PBI Capacity Scaling Schedule. It is possible to enter multiple comma separated schedules: [{},{}]
    Weekdays start at 0 (sunday) and end at 6 (saturday).
    If the script is executed outside the scaling schedule time slotsthat you defined, the server will be paused.

.PARAMETER scalingScheduleTimeZone
    Timezone of time slots in $scalingSchedule. 
    Available time zones: [System.TimeZoneInfo]::GetSystemTimeZones().

.EXAMPLE     
        -resourceGroupName myResourceGroup   
        -azureRunAsConnectionName AzureRunAsConnection 
        -serverName myserver 
        -scalingSchedule [{WeekDays:[1], StartTime:"06:59:59", StopTime:"17:59:59", Sku: "A4"}, {WeekDays:[2,3,4,5], StartTime:"06:59:59", StopTime:"17:59:59", Sku: "A2"}]
        -scalingScheduleTimeZone W. Europe Standard Time
   
.NOTES   
    Author: Dave Ruijter   
    Last Updated: Oct 2018      
#>  
param(
    [parameter(Mandatory=$true)]
    [string] $resourceGroupName,

    [parameter(Mandatory=$false)]
    [string] $azureRunAsConnectionName = "AzureRunAsConnection",

    [parameter(Mandatory=$true)]
    [string] $capacityName,

    [parameter(Mandatory=$true)]
    [string] $scalingSchedule,

    [parameter(Mandatory=$false)]
    [string] $scalingScheduleTimeZone = "W. Europe Standard Time"
)

filter timestamp {"[$(Get-Date -Format G)]: $_"}

Write-Output "Script started." | timestamp

$VerbosePreference = "Continue"
$ErrorActionPreference = "Stop"

#Authenticate with Azure Automation Run As account (service principal)
$runAsConnectionProfile = Get-AutomationConnection -Name $azureRunAsConnectionName
Add-AzAccount -ServicePrincipal -Tenant $runAsConnectionProfile.TenantId -ApplicationId $runAsConnectionProfile.ApplicationId -CertificateThumbprint ` $runAsConnectionProfile.CertificateThumbprint | Out-Null
Write-Output "Authenticated with Automation Run As Account." | timestamp

#Get current date/time and convert to $scalingScheduleTimeZone
$stateConfig = $scalingSchedule | ConvertFrom-Json
$startTime = Get-Date
Write-Output "Azure Automation local time: $startTime." | timestamp
$toTimeZone = [System.TimeZoneInfo]::FindSystemTimeZoneById($scalingScheduleTimeZone)
Write-Output "Time zone to convert to: $toTimeZone." | timestamp
$newTime = [System.TimeZoneInfo]::ConvertTime($startTime, $toTimeZone)
Write-Output "Converted time: $newTime." | timestamp
$startTime = $newTime

#Get current day of week based on converted start time
$currentDayOfWeek = [Int]($startTime).DayOfWeek
Write-Output "Current day of week: $currentDayOfWeek." | timestamp

# Get the scaling schedule for the current day of week
$dayObjects = $stateConfig | Where-Object {$_.WeekDays -contains $currentDayOfWeek } |Select-Object Sku, @{Name="StartTime"; Expression = {[datetime]::ParseExact($_.StartTime,"HH:mm:ss", [System.Globalization.CultureInfo]::InvariantCulture)}}, @{Name="StopTime"; Expression = {[datetime]::ParseExact($_.StopTime,"HH:mm:ss", [System.Globalization.CultureInfo]::InvariantCulture)}}

# Get the PBI Capacity object
$pbiEmbCap = Get-AzPowerBIEmbeddedCapacity -ResourceGroupName $resourceGroupName -Name $capacityName
Write-Output "PBI Capacity name found: $($pbiEmbCap.Name)" | timestamp
Write-Output "Current PBI Capacity status: $($pbiEmbCap.State), pricing tier: $($pbiEmbCap.Sku)" | timestamp

if($null -ne $dayObjects) { # Scaling schedule found for this day
    # Get the scaling schedule for the current time. If there is more than one available, pick the first
    $matchingObject = $dayObjects | Where-Object { ($startTime -ge $_.StartTime) -and ($startTime -lt $_.StopTime) } | Select-Object -First 1
    if($null -ne $matchingObject)
    {
        Write-Output "Scaling schedule found. Check if PBI Capacity is paused and if current pricing tier is matching..." | timestamp
        if($pbiEmbCap.State -eq "Paused")
        {
            Write-Output "PBI Capacity was paused. Resuming!" | timestamp
            $pbiEmbCap | Resume-AzPowerBIEmbeddedCapacity
            Write-Output "PBI Capacity resumed." | timestamp
        }
        if($pbiEmbCap.Sku.Name -ne $matchingObject.Sku)
        {
            Write-Output "PBI Capacity is not in the pricing tier of the scaling schedule. Changing!" | timestamp
            $pbiEmbCap = Update-AzPowerBIEmbeddedCapacity -Name $pbiEmbCap.Name -ResourceGroupName $resourceGroupName -Sku $matchingObject.Sku
            Write-Output "Change to edition/tier as specified in scaling schedule initiated..." | timestamp
            $pbiEmbCap = Get-AzPowerBIEmbeddedCapacity -ResourceGroupName $resourceGroupName -Name $capacityName
            Write-Output "Current PBI Capacity state: $($pbiEmbCap.State), pricing tier: $($pbiEmbCap.Sku.Name)" | timestamp
        }
        else
        {
            Write-Output "Current PBI Capacity pricing tier matches the scaling schedule already. Exiting..." | timestamp
        }
    }
    else { # Scaling schedule not found for current time
        Write-Output "No matching scaling schedule time slot for this time found. Check if the PBI Capacity is paused..." | timestamp
        if($pbiEmbCap.State -ne "Paused")
        {
            Write-Output "PBI Capacity not paused. Pausing!" | timestamp
            $pbiEmbCap | Suspend-AzPowerBIEmbeddedCapacity
            Write-Output "PBI Capacity paused." | timestamp
            $pbiEmbCap = Get-AzPowerBIEmbeddedCapacity -ResourceGroupName $resourceGroupName -Name $capacityName
            Write-Output "Current PBI Capacity sate: $($pbiEmbCap.State), pricing tier: $($pbiEmbCap.Sku.Name)" | timestamp
        }
        else
        {
            Write-Output "PBI Capacity paused already. Exiting..." | timestamp
        }
    }
}
else # Scaling schedule not found for this day
{
    Write-Output "No matching scaling schedule for this day found.  Check if the PBI Capacity is paused..." | timestamp
    if($pbiEmbCap.State -ne "Paused")
    {
        Write-Output "PBI Capacity not paused. Pausing!" | timestamp
        $pbiEmbCap | Suspend-AzPowerBIEmbeddedCapacity
        Write-Output "PBI Capacity paused." | timestamp
        $pbiEmbCap = Get-AzPowerBIEmbeddedCapacity -ResourceGroupName $resourceGroupName -Name $capacityName
        Write-Output "Current PBI Capacity state: $($pbiEmbCap.State), pricing tier: $($pbiEmbCap.Sku.Name)" | timestamp
    }
    else
    {
        Write-Output "PBI Capacity paused already. Exiting..." | timestamp
    }
}  

Write-Output "Script finished." | timestamp

Upgraded script forked from DaveRuijter/PowerBIEmbeddedScheduledAutoscaling.ps1 using https://docs.microsoft.com/en-us/powershell/azure/migrate-from-azurerm-to-az?view=azps-5.4.0