Dela via

Självstudie: Skapa för- och efterhändelser med hjälp av Azure Functions

  • Artikel

Gäller för: ✔️ Virtuella Windows-datorer med Virtuella Linux-datorer ✔️ ✔️ Lokal miljö ✔️ Azure VM Azure ✔️ Arc-aktiverade servrar.

I den här självstudien beskrivs hur du skapar för- och efterhändelser för att starta och stoppa en virtuell dator i ett arbetsflöde för schemakorrigering med Hjälp av Azure Functions.

I den här självstudien lär du dig att:

  • Förutsättningar
  • Skapa en funktionsapp
  • Skapa en funktion
  • Skapa en händelseprenumeration

Förutsättningar

  1. Se till att du använder PowerShell 7.2-runbook .

  2. Tilldela behörighet till hanterade identiteter – Du kan tilldela behörigheter till lämplig hanterad identitet. Runbooken kan använda antingen den systemtilldelade hanterade identiteten för Automation-kontot eller en användartilldelad hanterad identitet.

    Du kan använda antingen portal- eller PowerShell-cmdletar för att tilldela behörigheter till varje identitet:

    Följ stegen i Tilldela Azure-roller med hjälp av Azure Portal för att tilldela behörigheter

  1. Importera modulen Az.ResourceGraph och se till att modulen uppdateras till ThreadJob med modulversion 2.0.3.

Skapa en funktionsapp

  1. Följ stegen för att skapa en funktionsapp.

  2. När du har skapat funktionsappen Går du till resursen och ser till att du läser in beroendena genom att följa dessa steg:

    Kommentar

    Du behöver bara läsa in beroendena för första gången. Om PowerShell-beroendena inte kan läsas in. Kontrollera de senaste versionerna av AZ och AZ. ResourceGraph.

    1. I funktionsappen väljer du Appfiler.

    2. Under host.json aktiverar du ManagedDependecy till True och väljer requirements.psd1.

    3. Under requirements.psd1 klistrar du in följande kod:

       @{
 'Az'='12.*' 
 'Az.ResourceGraph'='1.0.0' 
 'Az.Resources'='6.*' 
 'ThreadJob' = '2.*'
 }

    4. Välj Spara.

  3. Starta om funktionsappen från fliken Översikt för att läsa in de beroenden som nämns i filen requirements.psd1 .

Skapa en funktion

  1. När du har skapat funktionsappen går du till Resurs och i Översikt väljer du Skapa i Azure Portal.

  2. I fönstret Skapa funktion gör du följande val:

    1. För egenskapen Utvecklingsmiljö väljer du Utveckla i portalen
    2. I Välj en mall väljer du Event Grid.
    3. I Mallinformation anger du namnet i Ny funktion och väljer sedan Skapa. Skärmbild som visar alternativen för att välja när du skapar en funktion.

  3. I funktionen Händelserutnät väljer du Kod+Test på den vänstra menyn, klistrar in följande kod och väljer Spara.

    # Make sure that we are using eventGridEvent for parameter binding in Azure function.
param($eventGridEvent, $TriggerMetadata)

Connect-AzAccount -Identity

# Install the Resource Graph module from PowerShell Gallery
# Install-Module -Name Az.ResourceGraph

$maintenanceRunId = $eventGridEvent.data.CorrelationId
$resourceSubscriptionIds = $eventGridEvent.data.ResourceSubscriptionIds

if ($resourceSubscriptionIds.Count -eq 0) {
    Write-Output "Resource subscriptions are not present."
    break
}

Write-Output "Querying ARG to get machine details [MaintenanceRunId=$maintenanceRunId][ResourceSubscriptionIdsCount=$($resourceSubscriptionIds.Count)]"

$argQuery = @"
    maintenanceresources 
    | where type =~ 'microsoft.maintenance/applyupdates'
    | where properties.correlationId =~ '$($maintenanceRunId)'
    | where id has '/providers/microsoft.compute/virtualmachines/'
    | project id, resourceId = tostring(properties.resourceId)
    | order by id asc
"@

Write-Output "Arg Query Used: $argQuery"

$allMachines = [System.Collections.ArrayList]@()
$skipToken = $null

do
{
    $res = Search-AzGraph -Query $argQuery -First 1000 -SkipToken $skipToken -Subscription $resourceSubscriptionIds
    $skipToken = $res.SkipToken
    $allMachines.AddRange($res.Data)
} while ($skipToken -ne $null -and $skipToken.Length -ne 0)
if ($allMachines.Count -eq 0) {
    Write-Output "No Machines were found."
    break
}

$jobIDs= New-Object System.Collections.Generic.List[System.Object]
$startableStates = "stopped" , "stopping", "deallocated", "deallocating"

$allMachines | ForEach-Object {
    $vmId =  $_.resourceId

    $split = $vmId -split "/";
    $subscriptionId = $split[2]; 
    $rg = $split[4];
    $name = $split[8];

    Write-Output ("Subscription Id: " + $subscriptionId)

    $mute = Set-AzContext -Subscription $subscriptionId
    $vm = Get-AzVM -ResourceGroupName $rg -Name $name -Status -DefaultProfile $mute

    $state = ($vm.Statuses[1].DisplayStatus -split " ")[1]
    if($state -in $startableStates) {
        Write-Output "Starting '$($name)' ..."

        $newJob = Start-ThreadJob -ScriptBlock { param($resource, $vmname, $sub) $context = Set-AzContext -Subscription $sub; Start-AzVM -ResourceGroupName $resource -Name $vmname -DefaultProfile $context} -ArgumentList $rg, $name, $subscriptionId
        $jobIDs.Add($newJob.Id)
    } else {
        Write-Output ($name + ": no action taken. State: " + $state) 
    }
}

$jobsList = $jobIDs.ToArray()
if ($jobsList)
{
    Write-Output "Waiting for machines to finish starting..."
    Wait-Job -Id $jobsList
}

foreach($id in $jobsList)
{
    $job = Get-Job -Id $id
    if ($job.Error)
    {
        Write-Output $job.Error
    }
}

  4. Välj Integrering på den vänstra menyn och redigera parameternamnet händelseutlösare under Utlösare. Använd samma parameternamn som anges i fönstret Kod+Test . I exemplet är parametern eventGridEvent.

    Skärmbild som visar parametern eventGridEvent.

  5. Välj Spara

Skapa en händelseprenumeration

  1. Logga in på Azure Portal och gå till Azure Update Manager.
  2. Under Hantera väljer du Datorer, Underhållskonfiguration.
  3. På sidan Underhållskonfiguration väljer du konfigurationen.
  4. Under Inställningar väljer du Händelser.
  5. Välj +Händelseprenumeration för att skapa en händelse före/efter underhåll.
  6. På sidan Skapa händelseprenumeration anger du följande information:
    1. I avsnittet Information om händelseprenumeration anger du ett lämpligt namn.
    2. Behåll schemat som Event Grid-schema.
    3. I avsnittet Händelsetyper filtrerar du till händelsetyper.
      1. Välj Förunderhållshändelse för en förhändelse.
        • I avsnittet Slutpunktsinformation väljer du Slutpunkten för Azure-funktionen och väljer Konfigurera och Slutpunkt.
        • Ange lämplig information, till exempel Resursgrupper, funktionsapp för att utlösa händelsen.
      2. Välj Efterunderhållshändelse för en efterhändelse.
        • I avsnittet Slutpunktsinformation väljer du Azure-funktionsslutpunkten och konfigurerar och slutpunkt.
        • Ange lämplig information, till exempel Resursgrupp, Funktionsapp för att utlösa händelsen.
  7. Välj Skapa.

Du kan också använda Azure Storage-konton och Händelsehubb för att lagra, skicka och ta emot händelser. Läs mer om hur du skapar händelsehubbar och lagringsköer.

Nästa steg