Guiden för kommandoradsaktiviteter

  • Artikel
  • 12 minuter för att läsa

Viktigt

Den här versionen av Orchestrator har nått slutet av supporten. Vi rekommenderar att du uppgraderar till Orchestrator 2019.

Guiden för kommandoradsaktiviteter låter dig snabbt skapa nya aktiviteter i Orchestrator genom att kapsla in kommandon, argument och parametrar i en Microsoft .NET-sammansättning (. DLL-fil). Guiden skapar C#-källkod med Orchestrator SDK och kompilerar den automatiskt åt dig. Med den här sammansättningen kan du använda .NET-integrationspaketet (en del av Integration Toolkit) för att testa dina aktiviteter och sedan använda guiden Integreringspaket för att paketera sammansättningen i ett anpassat integrationspaket som kan distribueras och distribueras precis som andra integrationspaket.

En sammansättning kan innehålla en eller flera aktiviteter (kommandon) och aktiviteterna kan vara en eller flera av de kommandotyper som är tillgängliga (Kommando, Kommandorad, PowerShell- eller SSH-kommando). Du definierar aktivitetsnamn, kommandostruktur, indataparametrar och även publicerade data (utdata).

Översikt över aktiviteter i Orchestrator

En aktivitet är en enda funktionell del av en Orchestrator-runbook. Aktiviteter är det som gör det faktiska arbetet i runbooks och sammans samman med hjälp av länkar som kan definieras med villkor för att skapa arbetsflödesgrenar. När du skapar en runbook med Runbook-designer drar och släpper du aktiviteter från fönstret Aktiviteter till runbooken och länkar dem sedan tillsammans för att skapa arbetsflödet. När runbooken körs anropar den varje aktivitet i följd enligt hur de länkades. Varje aktivitet utför en viss uppgift och kan samla in indata från Orchestrator-databussen och publicera dess utdata till samma databuss. Varje aktivitet har möjlighet att hämta publicerade data från någon av de aktiviteter som kördes före den i runbooken, och publicering av utdata gör att följande aktiviteter kan komma åt den.

Aktiviteter sträcker sig från mycket enkla till mycket komplexa. Du kan skapa en aktivitet med hjälp Command-Line aktivitetsguiden som inte gör något annat än ekar text till en utdataegenskap. Du kan också skapa en enda aktivitet som utför en komplex åtgärd i flera steg, till exempel distribution av virtuella datorer. Det är upp till dig att definiera vad varje aktivitet ska göra. Målet bör dock vara att definiera aktiviteter som kapslar in enskilda uppsättningar med funktioner som gör det enkelt att använda dem i många olika typer av situationer. Nyckeln är flexibilitet. Det är bättre att skapa en uppsättning med tio olika aktiviteter som var och en gör något specifikt och kan använda dessa aktiviteter på 20 olika sätt, i stället för att skapa 20 olika aktiviteter för att lösa de specifika enskilda scenarierna. Mer information om bästa praxis finns längre fram i det här dokumentet.

Skapa en ny aktivitetssammansättningen

Så här skapar du en ny kommandoradsaktivitetssamling

  1. Klicka på > Starta alla program > Microsoft System Center 2012 > Orchestrator > Integration Toolkit > Orchestrator Command-Line Aktivitetsguide

  2. Klicka på Nästa.

  3. På sidan Sammansättningsinformation anger du ett värde för Namn som börjar med en bokstav och följs av noll eller fler alfanumeriska tecken. Det här namnet används som en C#-namnrymdsidentifierare för sammansättningen och dina aktiviteter.

  4. I Sammansättningsfil anger du en sökväg och filnamn för sammansättningsfilen som ska skapas av den här guiden. Om den här filen redan finns uppmanas du att skriva över filen.

  5. Klicka på knappen Sammansättningsinformation . Du kan ange information här som blir egenskaperna för sammansättningsfilen, som visas i Windows Explorer via filegenskaper. Egenskapsvärdena definieras i tabellen nedan. Den här informationen är valfri och krävs inte för att skapa en sammansättning.

    Egenskap Beskrivning
    Rubrik Anger en rubrik för sammansättningen, som visas som egenskapen "Filbeskrivning" i Windows Explorer-egenskaper
    Description Anger en valfri beskrivning för sammansättningen, som inte visas i Windows Explorer-egenskaper
    Produkt Anger ett produktnamn för sammansättningen, som visas som egenskapen "Produktnamn" i Windows Explorer-egenskaper
    Företag Anger ett företagsnamn för sammansättningen, som inte visas i Windows Explorer-egenskaper
    Copyright Anger ett upphovsrättsmeddelande för sammansättningen, som visas som "Copyright" i Windows Explorer-egenskaper
    Varumärke Anger ett varumärke för sammansättningen, som visas som "Juridiska varumärken" i Windows Explorer-egenskaper
    Version Anger sammansättningsversion och filversion. Dessa visas i Windows Explorer som Filversion ochProduktversion.

    Versionsnumret har fyra delar, enligt följande:

    <huvudversion>.< delversion>.< build-nummer>.< Översyn>

  6. Klicka på OK när du är klar med att ange sammansättningsinformation.

  7. Klicka på Nästa. Sidan Kommandon visas.

  8. Lägg till ett eller flera kommandon genom att följa anvisningarna i Lägga till kommandon i en sammansättning.

  9. När du har slutfört definitionen av din aktivitet klickar du på OK. Dialogrutan stängs och din nya aktivitet läggs till i listan på sidan Kommandon. Om du behöver gå tillbaka och redigera ett kommando väljer du kommandot i listan och klickar på Redigera. Om du behöver ta bort ett kommando väljer du kommandot i listan och klickar på Ta bort.

  10. När du är klar med att lägga till och ändra kommandon klickar du på Nästa. Sammansättningsfilen som angavs i början av guiden kompileras och när processen är klar visas den sista guidesidan.

  11. Om du omedelbart vill skapa ett integrationspaket från den här nya sammansättningen klickar du på knappen Build Integration Pack (Bygg integrationspaket). Då startas guiden För integrationspaket och informationen läses in i förväg från sammansättningen. Följ sedan anvisningarna i Skapa ett nytt integrationspaket för att skapa integrationspaketet.

  12. Om du vill testa sammansättningen med aktiviteten Anropa .NET eller hoppa över IP-byggprocessen för tillfället klickar du på Slutför.

Lägga till kommandon i en sammansättning

Lägga till ett kommando i en sammansättning

  1. På sidan Kommandon kan du definiera ett eller flera kommandon (som blir aktiviteter) som läggs till i sammansättningen. Om du vill lägga till ett nytt kommando klickar du på Lägg till.

  2. Dialogrutan Lägg till/redigera kommando visar och innehåller tre flikar: Allmänt, Argument och Publicerade data. Ange ett Namn för kommandot. Detta blir det namn som visas i Runbook-designer för aktiviteten. Du kan även ange en Beskrivning för kommandot.

  3. Egenskapsväljaren Läge innehåller fyra alternativ: Kör kommando, Kör Windows PowerShell, Kör program och Kör SSH-kommando. Om du har valt läget Kör program blir fältet Program aktivt. Klicka på ellipsknappen (...) och bläddra efter det program som du vill köra.

    Anteckning

    Det program som valts i ett Körningsprogram-kommando anropas på runbook-servern där runbooken som innehåller den här aktiviteten körs. Därför måste det här programmet finnas på alla Runbook-servrar där du förväntar dig att köra runbooken.

  4. Klicka på fliken Argument.

  5. I fältet Kommandorad skriver du de kommando- eller kommandoradsparametrar som krävs av aktiviteten. Om kommandot ska ta parametrar som du vill att användarna ska ange måste du lägga till dem i listan Parametrar nedan och sedan använda knappen Infoga för att lägga till dem på kommandoraden.

    Viktigt

    Om du har angett Run Windows PowerShell for the Mode (Kör Windows PowerShell för läge) och du refererar till ett PowerShell-skript som ingår i integrationspaketet, måste du föregå namnet på skriptet med punkt- och snedstreckstecken för att referera till den lokala katalogen. Till exempel skulle .\MyScript.ps1 anges för ett skript med namnet MyScript.ps1. Det beror på att skriptfilen kopieras till standardkatalogen för integrationspaketet. När Windows PowerShell kör ett skript från den lokala katalogen måste den här notationen anges.

  6. Om du vill ange parametrar för en kommandorad klickar du på Lägg till. Dialogrutan Lägg till/redigera parameter visas.

  7. I fältet Namn anger du ett namn för den parameter som du lägger till. Det här är visningsnamnet för den parameter som visas i listan Egenskaper för aktiviteten.

  8. Välj det läge som du vill använda för parametern i listrutan Användningsläge. Användningsläget har två alternativ:

    Användningsläge Description
    Kommandoargument Välj att använda det här argumentet som parameter på kommandoraden ( med knappen Infoga ). Till exempel kan en kommandoargumentparameter med namnet "Folder" placeras på kommandoraden så här:

    Dir $(folder)Observera: Om kommandoradsargumenten innehåller blanksteg (till exempel mappnamn) kan du behöva ange dem inom citattecken för att kommandot ska fungera korrekt. Exempelvis: Dir "$(folder)"
    Miljövariabel Välj att använda det här argumentet som en miljövariabel som ska anges innan kommandoraden körs. Det kan användas som en kommandoradsparameter eller som en miljövariabel i ett skript som körs.

    Till exempel kan en miljövariabelparameter med namnet "Folder" placeras på kommandoraden så här:

    Dir %Folder%Viktigt: Miljövariabelnamnet finns redan i antingen användar- eller systemmiljöer. Kommandot misslyckas med ett felmeddelande som liknar följande: Objektet har redan lagts till. Nyckel i ordlista: "mapp"-nyckel som läggs till: "mapp" Du kan avgöra vilka miljövariabler som finns på en lokal dator eller fjärrdator genom att klicka på Starta >körning och sedan skriva MSINFO32.EXE. Välj sedan Miljövariabler > för programvarumiljö. Om du vill välja en annan dator< trycker du på CTRL+R>, väljer Fjärrdator i nätverket och anger datornamnet och klickar sedan på OK.

  9. I listrutan Visningsformat väljer du det format som du vill använda för att visa parametern. Visningsformatet avgör hur användaren interagerar med indata när de visas. Alternativen beskrivs nedan:

    Visningsformat Description
    Text Användaren får en textruta i fritt format för att ange ett värde
    Krypterad text Användaren får en maskerad textruta. Data i det här fältet krypteras i databasen och visas inte i några loggar
    Sant/falskt Användaren kan välja Sant eller Falskt i en popup-dialogruta
    Text med markering Användaren kan välja från en grupp med alternativ som du anger
    Datum/tid Användaren kan välja värdet med hjälp av en kontroll för datum/tid-väljaren
    Fil Användaren kan välja värdet med hjälp av en filwebbläsare
    Mapp Användaren kan välja värdet med hjälp av en mappwebbläsare
    Dator Användaren kan välja värdet med hjälp av en datorwebbläsare

  10. Om parametern kräver eller om du vill ange ett standardvärde skriver du det i fältet Standardvärde .

  11. Om du har valt Text med Markering aktiveras fältet Alternativ. Om du vill lägga till alternativvärden som användaren kan välja från klickar du på ellipsknappen bredvid fältet Alternativ och anger dem. Varje alternativ visas på en separat rad. När du är klar med att lägga till alternativ klickar du på OK.

  12. När du är klar med parameterdefinitionen klickar du på OK.

  13. Om den definieras som en kommandoparameter kan parametern nu läggas till på kommandoraden genom att placera markören vid önskad infogningspunkt på kommandoraden, klicka på knappen Infoga och välja parameternamnet. Om den definieras som en miljövariabel måste du manuellt skriva in variabeln (i formatet %variable%) om du vill ha den på kommandoraden.

  14. Om du väljer läget Kör programeller Kör kommando rad är kryssrutan för Inkludera arbetskatalogparameter aktiverad.

  15. Klicka på fliken Publicerade data. Inställningar på den här fliken kan du publicera utdata till Orchestrator-databussen så att andra aktiviteter kan använda informationen.

  16. Om du vill lägga till en ny publicerad dataegenskap klickar du på Lägg till.

  17. Om du har valt alternativet Kör kommando, Kör program eller Kör SSH-kommando i listrutan Läge på fliken Allmänt i dialogrutan Lägg till/redigera kommando visas följande objekt i dialogrutan Lägg till/redigera publicerade data:

    Poster Beskrivning
    Name Visningsnamnet för det publicerade dataobjekt som du skapar
    Källa Källan för det publicerade dataobjektet. Du kan välja mellan Standard Output Stream eller Standard Error Stream från kommandoraden
    Läge Det läge som du vill använda för att välja publicerade data.

    Använd matchningsmönster för att avgöra om ett visst mönster finns i källan. Detta returnerar True eller False.

    Använd Extrahera grupp för att hämta varje objekt med data som matchar det mönster som du anger
    Mönster Det reguljära uttryck som gäller för inställningen Läge
    Description Beskrivningstexten som visas bredvid egenskapen publicerade data i Runbook-designer. (valfritt)

  18. Om du valde alternativet Kör Windows PowerShell i listrutan Läge på fliken Allmänt i dialogrutan Lägg till/redigera kommando visas följande objekt i dialogrutan Lägg till/redigera publicerade data:

    Poster Beskrivning
    Name Visningsnamnet för det publicerade dataobjekt som du skapar
    Egenskap Namnet på den Windows PowerShell som ska sparas i det publicerade dataobjektet. Den här egenskapen måste finnas i ett objektutdata till PowerShell-pipelinen under skriptet och får inte vara ett objekt (ska kunna konverteras till en sträng).
    Description Beskrivningstexten som visas bredvid egenskapen publicerade data i Runbook-designer. (valfritt)

  19. Klicka på OK för att slutföra tillägget av objektet Publicerade data. Upprepa steg 16–18 för varje publicerat dataobjekt som du vill lägga till.

  20. Klicka på OK för att stänga dialogrutan Lägg till/redigera kommando och återgå till dialogrutan Kommandon.

Testa en aktivitetssamling

När du har skapat en sammansättning kan du testa den med aktiviteten Anropa .NET (finns i INTEGRATION Toolkit IP för .NET) för att kontrollera att den fungerar som förväntat innan du konverterar den till ett anpassat integrationspaket.

Testa och montera

  1. Öppna Runbook-designer.

  2. Skapa en ny Runbook.

  3. I fönstret Aktiviteter klickar du på kategorin Integration Toolkit för att expandera den och drar en Invoke .NET-aktivitet till den nya runbooken.

  4. Dubbelklicka på objektet Anropa .NET för att visa dialogrutan Egenskaper.

  5. I fältet Sammansättning bläddrar du efter sammansättningsfilen som du skapade med hjälp av aktivitetsguiden för Command-Line (eller via anpassad utveckling med SDK) genom att klicka på ellipsknappen (...) till höger om fältet. Välj filen och klicka sedan på Öppna.

  6. Klicka på ellipsknappen till höger om fältet Klass för att visa en lista över de enskilda kommandona i sammansättningen. Välj en kommandoklass och klicka på OK. Parametrarna för den här klassen visas på fliken Egenskaper i dialogrutan.

  7. Fältet Installation används endast av egenutvecklade klasser med Orchestrator SDK med attributet OrchestratorData. Mer information om SDK finns i System Center Orchestrator Integration Toolkit SDK.

  8. Klicka på fliken Egenskaper.

  9. Ange informationen för var och en av egenskaperna efter behov.

  10. Klicka på Slutför för att spara inställningarna och återgå till runbooken.

  11. Klicka Runbook Tester i verktygsfältet i Runbook-designer. Den Runbook Tester startar.

  12. Klicka på Kör till brytpunkt i verktygsfältet. Runbooken startar och aktiviteten körs. Resultatet av aktiviteten visas i fönstret Kör logg.

  13. Klicka på Visa information under aktivitetsnamnet i fönstret Kör logg för att se detaljerade resultat, inklusive indataegenskaper och publicerade data.

QIK CLI-aktivitetsmigrering

Om du har en sammansättning som har skapats med opalis 6.3 QIK CLI-guiden måste du konvertera den så att den är kompatibel med Orchestrator innan den kan användas antingen i ett Orchestrator Integration Pack eller användas direkt i runbooks via aktiviteten Anropa .NET. Konverteringsprocessen är enkel och tar bara några sekunder per sammansättning.

Viktigt

Installationen av Orchestrator Integration Toolkit misslyckas inte om Microsoft .NET Framework 3.5, Service Pack 1 inte är installerat, men olika åtgärder i aktivitetsguiden för Command-Line misslyckas om det inte finns. Kontrollera att Microsoft .NET Framework 3.5, Service Pack 1 är installerat innan du använder CLI.

Konvertera en Opalis QIK CLI-sammansättning

  1. Starta guiden Orchestrator Command-Line-aktivitet genom att klicka på Guiden >> Starta alla program Microsoft System Center 2012 > Orchestrator > Command-Line Aktivitetsguide

  2. När guiden läses in klickar du på knappen Läs in befintlig sammansättning på den första sidan.

  3. Välj din befintliga sammansättningsfil och klicka sedan på Öppna. Sammansättningens namn och filplats visas.

  4. Ändra sökvägen till filen så att ändringarna sparas i en ny fil. Du kan också ändra namnet på sammansättningen om det behövs.

  5. Om du behöver göra ytterligare ändringar i sammansättningsinformationen klickar du på knappen Sammansättningsinformation och gör dessa ändringar. Klicka på OK när du är klar för att återgå till sidan Sammansättningsinformation.

  6. Klicka på Nästa för att gå till sidan Kommandon. Du bör se en lista över kommandon som tidigare har definierats i sammansättningen. Granska kommandona om det behövs och klicka på Nästa för att fortsätta till sidan Byggmontering .

  7. Den nya sammansättningen kommer att byggas åt dig och sparas med hjälp av sökvägen och filnamnet som du definierade tidigare.

  8. Du kan nu använda din nya Orchestrator-kompatibla sammansättning i runbooks med aktiviteten Anropa .NET, eller så kan du skapa ett integrationspaket från den här sammansättningen genom att klicka på knappen Skapa integrationspaket . Om du inte vill skapa en IP-adress just nu klickar du på Stäng för att avsluta guiden.

Informationskällor för Orchestrator

Förutom den här onlinereferensen för System Center 2012 Orchestrator finns det ett antal resurser som kan ge ytterligare information om hur du skapar runbooks, använder Integration Toolkit och metodtips.

Resurs Location
System Center Start https://www.microsoft.com/en-us/cloud-platform/system-center
System Center dokumentation https://docs.microsoft.com/system-center/
Orchestrator-teamets blogg på TechNet https://blogs.technet.microsoft.com/orchestrator/
Orchestrator Community-forum på TechNet https://social.technet.microsoft.com/Forums/en-US/home?category=systemcenterorchestrator