Fixed spelling of ExtendedProperties.SubscriptionPolices in readmes

2025-12-08 14:58:54 +00:00 · 2025-06-10 11:49:24 -07:00
parent d2d6f974b4
commit bc8bede5f2
3 changed files with 180 additions and 0 deletions
@@ -20,6 +20,8 @@ ms.date: 06/21/2025

    05/30/2025 - Added transcript support

+    06/10/2025 - Fixed a RG filter for SQL DB
+

 # Overview

@@ -18,6 +18,7 @@
    1.0.0 - Initial version.
    1.0.2 - Modified to fix errors and to remove the auto-start of the offline resources.
    1.0.3 - Added transcript.
+    1.0.4 - Fixed RG filter for SQL DB

 .PARAMETER SubId
    A single subscription ID or a CSV file name containing a list of subscriptions.
@@ -487,6 +488,9 @@ foreach ($sub in $subscriptions) {
                if ($tagsFilter) {
                    $dbQuery += "$tagsFilter"
                }
+                if ($rgFilter) {
+                    $dbQuery += " && $rgFilter"
+                }
                
                $dbQuery += "].{name:name, licenseType:licenseType, location:location, resourceGroup:resourceGroup, id:id, ResourceType:type, State:status}"
                
@@ -0,0 +1,174 @@
+#
+# This script provides a scalable method to switch the license type to pay-as-you-go (aka LicenseIncluded) for all SQL resources in a specific subscription or the entire tenant. By default, the script scans
+# all subscriptions the user account has access. Alternatively, you can specify a single subscription or a .CSV file
+# with a list of subscription. The usage report includes the list of resources that have been affected by the change.
+#
+# The following resources are in scope for the license utilization analysis:
+# - Azure SQL databases (vCore-based purchasing model only)
+# - Azure SQL elastic pools (vCore-based purchasing model only)
+# - Azure SQL managed instances
+# - Azure SQL instance pools
+# - Azure Data Factory SSIS integration runtimes
+# - SQL Servers in Azure virtual machines
+#
+# The script accepts the following command line parameters:
+#
+# -SubId [subscription_id] | [csv_file_name]        (Accepts a .csv file with the list of subscriptions)
+# -Cred [credential_object]                         (Required to save data to the database)
+# -FilePath [csv_file_name]                         (Required to save data in a .csv format. Ignored if database parameters are specified)
+#
+
+param (
+    [Parameter (Mandatory= $false)]
+    [string] $SubId,
+    [Parameter (Mandatory= $false)]
+    [PSCredential] $Cred,
+    [Parameter (Mandatory= $false)]
+    [string] $FilePath
+)
+
+function CheckModule ($m) {
+
+    # This function ensures that the specified module is imported into the session
+    # If module is already imported - do nothing
+
+    if (!(Get-Module | Where-Object {$_.Name -eq $m})) {
+         # If module is not imported, but available on disk then import
+        if (Get-Module -ListAvailable | Where-Object {$_.Name -eq $m}) {
+            Import-Module $m
+        }
+        else {
+
+            # If module is not imported, not available on disk, but is in online gallery then install and import
+            if (Find-Module -Name $m | Where-Object {$_.Name -eq $m}) {
+                Install-Module -Name $m -Force -Verbose -Scope CurrentUser
+                Import-Module $m
+            }
+            else {
+
+                # If module is not imported, not available and not in online gallery then abort
+                write-host "Module $m not imported, not available and not in online gallery, exiting."
+                EXIT 1
+            }
+        }
+    }
+}
+
+#
+# Suppress warnings
+#
+Update-AzConfig -DisplayBreakingChangeWarning $false
+
+$requiredModules = @(
+    "Az.Accounts",
+    "Az.Compute",
+    "Az.DataFactory",
+    "Az.Resources",
+    "Az.Sql",
+    "Az.SqlVirtualMachine"
+)
+$requiredModules | Foreach-Object {CheckModule $_}
+
+# Subscriptions to scan
+
+if ($SubId -like "*.csv") {
+    $subscriptions = Import-Csv $SubId
+}elseif($SubId -ne $null){
+    $subscriptions = [PSCustomObject]@{SubscriptionId = $SubId} | Get-AzSubscription
+}else{
+    $subscriptions = Get-AzSubscription
+}
+
+#Log file setup
+if (!$PSBoundParameters.ContainsKey("FilePath")) {
+    $FilePath = '.\sql-change-log.csv'
+}
+
+Write-Host ([Environment]::NewLine + "-- Scanning subscriptions --")
+
+# Calculate usage for each subscription
+
+foreach ($sub in $subscriptions){
+
+    if ($sub.State -ne "Enabled") {continue}
+
+    try {
+        Set-AzContext -SubscriptionId $sub.Id
+    }catch {
+        write-host "Invalid subscription: " $sub.Id
+        {continue}
+    }
+
+    # Get all resource groups in the subscription
+    $rgs = Get-AzResourceGroup
+
+    # Get all logical servers
+    $servers = Get-AzSqlServer
+
+    # Scan all vCore-based SQL database resources in the subscription
+    $servers | Get-AzSqlDatabase | Where-Object { $_.SkuName -ne "ElasticPool" -and $_.Edition -in @("GeneralPurpose", "BusinessCritical", "Hyperscale") } | ForEach-Object {
+        if ($_.LicenseType -ne "LicenseIncluded") {
+            Set-AzSqlDatabase -ResourceGroupName $_.ResourceGroupName -ServerName $_.ServerName -DatabaseName $_.DatabaseName -LicenseType "LicenseIncluded"
+            Write-Host ([Environment]::NewLine + "-- Database $_.DatabaseName is set to \"LicenseIncluded\"")
+        }
+    }
+    [system.gc]::Collect()
+
+    # Scan all vCore-based SQL elastic pool resources in the subscription
+    $servers | Get-AzSqlElasticPool | Where-Object { $_.Edition -in @("GeneralPurpose", "BusinessCritical", "Hyperscale") } | ForEach-Object {
+        if ($_.LicenseType -ne "LicenseIncluded") {
+            Set-AzSqlElasticPool -ResourceGroupName $_.ResourceGroupName -ServerName $_.ServerName -ElasticPoolName $_.ElasticPoolName -LicenseType "LicenseIncluded"
+            Write-Host ([Environment]::NewLine + "-- ElasticPool $_.ElasticPoolName is set to \"LicenseIncluded\"")
+        }
+    } 
+    [system.gc]::Collect()
+
+    # Scan all SQL managed instance resources in the subscription
+    Get-AzSqlInstance | Where-Object { $_.InstancePoolName -eq $null } | ForEach-Object {
+        if ($_.LicenseType -ne "LicenseIncluded") {
+            Set-AzSqlInstance -ResourceGroupName $_.ResourceGroupName -ServerName $_.ServerName -InstanceName $_.InstanceName -LicenseType "LicenseIncluded"
+            Write-Host ([Environment]::NewLine + "-- ElasticPool $_.ElasticPoolName is set to \"LicenseIncluded\"")
+        }      
+    }
+    [system.gc]::Collect()
+
+    # Scan all instance pool resources in the subscription
+    Get-AzSqlInstancePool | Foreach-Object {
+        if ($_.LicenseType -ne "LicenseIncluded") {
+            Set-AzSqlInstancePool -ResourceGroupName $_.ResourceGroupName -ServerName $_.ServerName -InstanceName $_.InstanceName -LicenseType "LicenseIncluded"
+            Write-Host ([Environment]::NewLine + "-- InstancePool $_.InstanceName is set to \"LicenseIncluded\"")
+        }
+    }
+    [system.gc]::Collect()
+
+    # Scan all SSIS imtegration runtime resources in the subscription
+    $rgs | Get-AzDataFactoryV2 | Get-AzDataFactoryV2IntegrationRuntime | Where-Object { $_.State -eq "Started" -and $_.NodeSize -ne $null } | ForEach-Object {
+        if ($_.LicenseType -ne "LicenseIncluded") {
+            # Set the license type to "LicenseIncluded"
+            Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $_.ResourceGroupName -DataFactoryName $_.DataFactoryName -Name $_.Name -LicenseType "LicenseIncluded"
+            Write-Host ([Environment]::NewLine + "-- DataFactory $_.DataFactoryName is set to \"LicenseIncluded\"")
+        }
+    }
+    [system.gc]::Collect()
+
+    # Scan all SQL VMs in the subscription
+    $rgs | Get-AzVM | Where-Object { $_.StorageProfile.ImageReference.Offer -like "*sql*" -and $_.ProvisioningState -eq "Succeeded" } | ForEach-Object {
+        $vmName = $_.Name
+        $resourceGroupName = $_.ResourceGroupName
+    
+        # Get the SQL configuration for the VM
+        $sqlConfig = Get-AzVMExtension -ResourceGroupName $resourceGroupName -VMName $vmName -Name "SqlIaaSAgent"
+        
+        if ($sqlConfig -ne $null) {
+            $licenseType = $sqlConfig.Settings.LicenseType
+    
+            if ($licenseType -ne "LicenseIncluded") {
+                # Set the license type to "LicenseIncluded"
+                Set-AzVMExtension -ResourceGroupName $resourceGroupName -VMName $vmName -Name "SqlIaaSAgent" -Publisher "Microsoft.SqlServer.Management" -ExtensionType "SqlIaaSAgent" -TypeHandlerVersion "1.5" -Settings @{ "LicenseType" = "LicenseIncluded" }
+                Write-Host ([Environment]::NewLine + "-- SQL VM $vmName is set to \"LicenseIncluded\"")
+            }
+    
+        }
+    }
+    [system.gc]::Collect()
+}