added activate license script

samples/manage/azure-arc-enabled-sql-server/activate-pcore-license/README.md

@@ -0,0 +1,86 @@
+---
+services: Azure SQL
+platforms: Azure
+author: anosov1960
+ms.author: sashan
+ms.date: 06/12/2024
+---
+
+# Overview
+
+This script performes a scheduled activation of a SQL Server p-core license.
+
+# Required permissions
+
+Your RBAC role must include the following permissions:
+
+- Microsoft.AzureArcData/SqlLicenses/read
+- Microsoft.AzureArcData/SqlLicenses/write
+- Microsoft.Management/managementGroups/read
+- Microsoft.Resources/subscriptions/read
+- Microsoft.Resources/subscriptions/resourceGroups/read
+- Microsoft.Support/supporttickets/write
+
+# Launching the script
+
+The script accepts the following command line parameters:
+
+| **Parameter**                                          | **Value**                                                                       | **Description** |
+|:--|:--|:--|
+|-licenseId| License resource URI |
+|-UseInRunbook| \$True or \$False (default) | Optional: must be $True when executed as a Runbook|
+
+
+## Example 
+
+The following command activate the license 
+
+```PowerShell
+.\activate-pcore-license.ps1 -licenseID <rsource URI>
+```
+
+# Running the script using Cloud Shell
+
+To run the script in the Cloud Shell, use the following steps:
+
+1. Launch the [Cloud Shell](https://shell.azure.com/). For details, read [PowerShell in Cloud Shell](https://aka.ms/pscloudshell/docs).
+
+2. Upload the script to the shell using the following command:
+
+    ```console
+    curl https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/manage/azure-hybrid-benefit/sql-license-usage.ps1 -o sql-license-usage.ps1
+    ```
+
+3. Run the script with a set of parameters that reflect your desired configuration.
+
+    ```console
+   .\activate-pcore-license.ps1 -licenseID <rsource URI>
+    ```
+
+> [!NOTE]
+> - To paste the commands into the shell, use `Ctrl-Shift-V` on Windows or `Cmd-v` on MacOS.
+> - The `curl` command will copy the script directly to the home folder associated with your Cloud Shell session.
+
+# Running the script as a Azure runbook
+
+You can scahedule to run the the command as a runbook. To set it up using Azure Portal, follow these steps.
+
+1. Open a command shell on your device and run this command. It will copy the script to your local folder.
+```console
+curl https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/manage/azure-hybrid-benefit/sql-license-usage.ps1 -o sql-license-usage.ps1
+```
+2. [Create a new automation account](https://ms.portal.azure.com/#create/Microsoft.AutomationAccount)  or open an existing one.
+1. Select *Run as accounts* in the **Account Settings** group, open the automatically created *Azure Run As Account* and note or copy the Display Name property. You must add this user to all the target subscriptions with at least a *Reader* access role. To collect the Unregistered vCores, the user must be at least a *Contributor*. See [Role assignment portal](https://docs.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal) for the instructions about role assignments.
+1. Select *Credentials* in the **Shared resources** group and create a credential object with the database username and password. The script will use these to connect to the specified database to save the license utilization data.
+1. Select *Modules* in the **Shared resources** group and make sure your automation account have the following PowerShell modules installed. If not, add them from the Gallery.
+    - Az.Accounts
+    - Az.Resources
+1. Select *Runbooks* in the **Process automation** group and click on *Import a runbook*, select the file you downloaded in Step 1 and click **Create**.
+1. When import is completed, click the *Publish* button.
+1. From the runbook blade, click on the *Link to schedule* button and select an existing schedule or create a new one with the desired frequency of runs and the expiration time.
+1. Click on *Parameters and run settings* and specify the following parameters:
+    - LICENSEID. Put in teh resourec URI
+    - USEINRUNBOOKS. Select True to activate the logic that authenticates the runbook using the *Azure Run As Account*.
+1. Click **OK** to link to the schedule and **OK** again to create the job.
+
+For more information about the runbooks, see the [Runbook tutorial](https://docs.microsoft.com/en-us/azure/automation/learn/automation-tutorial-runbook-textual-powershell)

samples/manage/azure-arc-enabled-sql-server/activate-pcore-license/activate-pcore-license.md

@@ -0,0 +1,83 @@
+#
+# This script performes a scheduled activation of a SQL Server p-core license.
+#
+# The script accepts the following command line parameters:
+#
+# -licenseID           (The specific resource URI)
+#
+
+param (
+    [Parameter (Mandatory= $true)]
+    [string] $licenseId,
+    [Parameter (Mandatory= $false)]
+    [string] $UseInRunbook = $true
+)
+
+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
+
+#The following block is required for runbooks only
+if ($UseInRunbook){
+
+    # Ensures you do not inherit an AzContext in your runbook
+    Disable-AzContextAutosave –Scope Process
+
+    $connection = Get-AutomationConnection -Name AzureRunAsConnection
+
+    # Wrap authentication in retry logic for transient network failures
+    $logonAttempt = 0
+    while(!($connectionResult) -and ($logonAttempt -le 10))
+    {
+        $LogonAttempt++
+        # Logging in to Azure...
+        $connectionResult = Connect-AzAccount `
+                            -ServicePrincipal `
+                            -Tenant $connection.TenantID `
+                            -ApplicationId $connection.ApplicationID `
+                            -CertificateThumbprint $connection.CertificateThumbprint
+
+        Start-Sleep -Seconds 5
+    }
+}else{
+    # Ensure that the required modules are imported
+    # In Runbooks these modules must be added to the automation account manually
+
+    $requiredModules = @(
+        "Az.Accounts",
+        "Az.Resources"
+    )
+    $requiredModules | Foreach-Object {CheckModule $_}
+}
+
+$newActivationState = "Activated"
+Set-AzResource -ResourceId $licenseId -PropertyObject @{"properties.activationState" = $newActivationState} -Force
+