Hantera runtime-miljö och associerade runbooks

Följ dessa steg för att skapa en Runtime-miljö:

1. Logga in på Azure-portalen och välj ditt Automation-konto.

2. På sidan Översikt väljer du Prova Körningsmiljö, om inte redan i den nya upplevelsen.

3. Under Processautomatisering väljer du Körningsmiljöer och sedan Skapa.

4. I fliken Grundläggande anger du följande information:

   1. Namn på Runtime-miljön. Den måste börja med alfabetet och får endast innehålla alfabet, siffror, understreck och bindestreck.

   2. I listrutan Språk väljer du skriptspråket för Runtime-miljön.

      • Välj PowerShell för PowerShell-skriptspråk eller Python för Python-skriptspråk.

   3. Välj Körningsversion för skriptspråk.

      • För PowerShell – välj 5.1, 7.4
      • För Python – välj 3.10

   4. Ange lämplig beskrivning.

      

5. Välj Nästa och på fliken Paket laddar du upp de paket som krävs under runbook-körningen. Az PowerShell-paketet laddas upp som standard för alla PowerShell Runtime-miljöer, som innehåller alla cmdletar för hantering av Azure-resurser.

   Kommentar

   Azure CLI-kommandon stöds i runbooks som är associerade med PowerShell 7.4 Runtime-miljön. Azure CLI-kommandon version 2.64.0 är tillgängliga som standardpaket i PowerShell 7.4 Runtime-miljön.

6. Ladda upp fler paket som krävs under runbook-körningen. Välj Lägg till en fil för att lägga till de filer som lagras lokalt på datorn eller välj Lägg till från galleriet för att ladda upp paket från PowerShell-galleriet.

   Kommentar

   • När du importerar ett paket kan det ta flera minuter. 100 MB är den maximala totala storleken på de filer som du kan importera.
   • Använd .zip filer för PowerShell-runbook-typer som beskrivs här.
   • För Python 3.10-paket använder du .whl-filer som riktar sig till cp310 Linux OS.

7. Välj Nästa och kontrollera att inställningarna är korrekta på fliken Granska + Skapa . När du väljer Skapa kör Azure validering på Inställningar för Körningsmiljö som du har valt. Om valideringen godkänns kan du fortsätta att skapa En runtime-miljö. Portalen anger de inställningar som du behöver ändra.

På sidan Körningsmiljöer kan du visa den nyligen skapade Körningsmiljön för ditt Automation-konto. Om du inte hittar de nyligen skapade Runtime-miljöerna i listan väljer du Uppdatera.

Du kan skapa en ny Runtime-miljö för PowerShell 7.4 med Az PowerShell-modulen i Automation.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.4" 
        }, 
        "defaultPackages": { 
            "Az": "12.3.0" 
        } 
     }, 
    "name": "<runtimeEnvironmentName>" 
} 

Ladda upp ett paket med Az.Accounts till Runtime-miljön.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2024-10-23

{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

Följ det här steget om du vill visa en lista över alla Runtime-miljöer från Automation-kontot:

1. I automationskontot går du till Processautomatisering och väljer Körmiljö.

   

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2024-10-23

Följ dessa steg för att ta bort Runtime-miljön från Automation-kontot:

1. I automationskontot går du till Processautomatisering och väljer Körmiljö.

2. Välj den körningsmiljö som du vill ta bort.

3. Välj Ta bort för att ta bort Körningsmiljön.

   

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23

Följ dessa steg för att uppdatera en Runtime-miljö:

1. I automationskontot går du till Processautomatisering och väljer Körmiljö.

2. Välj den Körningsmiljö som du vill uppdatera.

3. Välj versionen från listrutan för att uppdatera versionen av befintliga paket.

4. Välj Spara.

   

5. Välj Lägg till en fil för att ladda upp paket från den lokala datorn eller Lägg till från galleriet för att ladda upp paket från PowerShell-galleriet.

   Kommentar

   Du kan lägga till upp till 10 paket åt gången i Runtime-miljön. Se till att du sparar när du har lagt till 10 paket.

Uppdatera Az-modulversionen av en befintlig Runtime-miljö.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "12.3.0" 

        } 

     } 

} 

Krav

• Se till att du har skapat en Runtime-miljö innan du skapar en runbook.

Följ dessa steg för att skapa en ny runbook som är länkad till Runtime-miljön:

1. I ditt Automation-konto går du till Processautomatisering och väljer Runbooks.

2. Välj Skapa.

3. På fliken Grundläggande kan du antingen skapa en ny runbook eller ladda upp en fil från din lokala dator eller från PowerShell-galleriet.

   1. Ange ett Namn för runbooken. Den måste börja med en bokstav och får endast innehålla bokstäver, siffror, understreck och bindestreck.

   2. I listrutan Runbook-typ väljer du den typ av runbook som du vill skapa.

   3. Välj Körningsmiljö som ska konfigureras för runbooken. Du kan antingen välja från befintliga Runtime-miljöer eller Skapa en ny Runtime-miljö och länka den till Runbook. Listan över körningsmiljöer fylls i baserat på den Runbook-typ som valts i steg b.

   4. Ange lämplig beskrivning.

      

   Kommentar

   För PowerShell Runbook Type visas endast PowerShell Runtime-miljön för markering. För Python Runbook Type visas endast Python Runtime-miljöer för val.

4. Lägg till taggar i runbooken, granska inställningarna och välj Skapa för att skapa en ny runbook.

Den här runbooken är länkad till den valda Runtime-miljön. Alla paket i den valda Runtime-miljön skulle vara tillgängliga under körningen av runbooken.

Krav

• Konfigurera en PowerShell Runtime-miljö och ange den som indata för att skapa en runbook.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23

{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
} 

Följ dessa steg för att uppdatera en körbok:

1. I ditt Automation-konto går du till Processautomatisering och väljer Runbooks.

2. Markera kryssrutan för de runbooks som du vill uppdatera.

3. Välj Uppdatera körningsmiljö.

   

4. Välj Runtime-miljön i listrutan som du vill länka runbooks till.

5. Välj Uppdatera för att uppdatera valda runbooks med ny Runtime-miljö.

Kontrollera om runbooken körs som förväntat efter uppdateringen. Om runbooken inte ger det förväntade resultatet kan du återigen uppdatera Runtime-miljön till den gamla upplevelsen genom att följa stegen 1–4.

Uppdatera Runtime-miljön som är länkad till en runbook.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23
{ 
  "properties": { 
    "type": "PowerShell",
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Du kan uppdatera runbooks genom att ändra runtime-miljön som är länkad till den runbooken. Vi rekommenderar att du testar runbook-körningen innan du publicerar ändringarna. Det är för att säkerställa att runbooken fungerar som förväntat.

Följ dessa steg för att testa runbook-körningen innan du publicerar ändringar i Körningsmiljön:

1. Gå till sidan Runbooks och välj runbook som du vill uppdatera Runtime-miljön för.

   

2. På sidan Redigera runbook väljer du Redigera i portalen för att öppna textredigeraren.

3. Fältet Körningsmiljö visar den befintliga konfigurationen. Välj den nya Körningsmiljön i listrutan.

4. Välj testfönstret för att testa runbook-körning med den uppdaterade Runtime-miljön. Välj Starta för att påbörja testkörningen.

5. Stäng testfönstret och gör nödvändiga ändringar i Runbook-kod eller Runtime-miljö om det behövs.

6. Välj Publicera för att uppdatera runtime-miljön som är länkad till runbooken.

7. Välj Ja för att åsidosätta den tidigare publicerade versionen och bekräfta ändringarna.

Kör ett testjobb för en runbook med en annan Runtime-miljö. Det här scenariot är användbart när en runbook måste testas med en Runtime-miljö före uppdateringen.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>/draft/testJob?api-version=2024-10-23
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Du kan köra runbooks som är länkade till Runtime Environment både i Azure och Hybrid Worker.

Jobb ärver Runtime-miljön från runbooken. Kör ett molnjobb för en publicerad runbook.

PUT
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/jobs/<jobName>?api-version=2024-10-23
{
  "properties": {
    "runbook": {
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
}