Delen via

De wizard Opdrachtregelactiviteit

  • Artikel

Belangrijk

Deze versie van Orchestrator heeft het einde van de ondersteuning bereikt. U wordt aangeraden een upgrade uit te voeren naar Orchestrator 2019.

Met de wizard Command-Line activiteit kunt u snel nieuwe activiteiten maken in Orchestrator door opdrachten, argumenten en parameters in te kapselen in een Microsoft .NET-assembly (.DLL). De C#-broncode wordt automatisch met de Orchestrator SDK gemaakt en gecompileerd. Met deze assembly kunt u het .NET-integratiepakket (onderdeel van de Integration Toolkit) gebruiken om uw activiteiten te testen en vervolgens de wizard Integratiepakket gebruiken om de assembly te verpakken in een aangepast integratiepakket dat kan worden gedistribueerd en geïmplementeerd, net als andere integratiepakketten.

Een assembly kan een of meer activiteiten (opdrachten) bevatten en de activiteiten kunnen een of meer van de beschikbare opdrachttypen zijn (Opdracht, Opdrachtregel, PowerShell of SSH-opdracht). U definieert de naam van de activiteit, de opdrachtstructuur, de invoerparameters en zelfs de gepubliceerde gegevens (uitvoer).

Overzicht van activiteiten in Orchestrator

Een activiteit is één functioneel onderdeel van een Orchestrator-runbook. Activiteiten zijn wat het werkelijke werk binnen runbooks doet en worden samengevoegd met behulp van koppelingen die kunnen worden gedefinieerd met voorwaarden voor het maken van werkstroomtakken. Wanneer u een runbook bouwt met Runbook Designer, sleept u activiteiten vanuit het deelvenster Activiteiten naar het runbook en koppelt u ze aan elkaar om de werkstroom te vormen. Wanneer het runbook wordt uitgevoerd, wordt elke activiteit op volgorde aangeroepen op basis van de manier waarop ze zijn gekoppeld. Elke activiteit voert een specifieke taak uit en kan invoergegevens van de Orchestrator-gegevensbus verzamelen en de uitvoer ervan publiceren naar dezelfde gegevensbus. Elke activiteit heeft de mogelijkheid om gepubliceerde gegevens te trekken uit een van de activiteiten die daarvoor in het runbook zijn uitgevoerd. Als u uitvoergegevens publiceert, hebben de volgende activiteiten er toegang toe.

Activiteiten variëren van eenvoudig tot complex. U kunt een activiteit maken met behulp van de wizard Command-Line activiteit die alleen tekst naar een uitvoereigenschap echo's uitvoert. U kunt ook één activiteit maken waarmee een complexe actie met meerdere stappen wordt uitgevoerd, zoals de implementatie van virtuele machines. Het is aan u om te definiëren wat elke activiteit doet. Uw doel moet echter zijn om activiteiten te definiëren die één set functionaliteiten inkapselen die eenvoudig opnieuw kunnen worden gebruikt in veel verschillende soorten situaties. De sleutel is flexibiliteit. Het is beter om een set van tien verschillende activiteiten te maken die elk iets specifieks doen en die activiteiten op 20 verschillende manieren kunnen gebruiken, in plaats van 20 verschillende activiteiten te maken om de specifieke afzonderlijke scenario's op te lossen. Meer informatie over best practices wordt verderop in dit document behandeld.

Een nieuwe activiteitsassembly maken

Een nieuwe assembly voor opdrachtregelactiviteiten maken

Volg deze stappen om een nieuwe opdrachtregelactiviteitsassembly te maken:

  1. Selecteer Start > All Programs > Microsoft System Center 2012 > Orchestrator > Integration Toolkit > Orchestrator Command-Line Activity Wizard

  2. Selecteer Next.

  3. Voer op de pagina Assemblydetails een waarde in voor Naam die begint met een letter en wordt gevolgd door nul of meer alfanumerieke tekens. Deze naam wordt gebruikt als een C#-naamruimte-id voor de assembly en uw activiteiten.

  4. Voer in Assemblybestand een pad en bestandsnaam in van het assemblybestand dat door deze wizard wordt gemaakt. Als dit bestand al bestaat, wordt u gevraagd het bestand te overschrijven.

  5. Selecteer Assembly-informatie. U kunt hier gegevens invoeren die de eigenschappen van het assemblybestand worden, zichtbaar in Windows Verkenner via bestandseigenschappen. De eigenschapswaarden worden gedefinieerd in de onderstaande tabel. Deze informatie is optioneel en niet vereist voor het bouwen van een assembly.

    Eigenschap Beschrijving
    Titel Hiermee geeft u een titel voor de assembly op, die wordt weergegeven als de eigenschap Bestandsbeschrijving in eigenschappen van Windows Verkenner
    Beschrijving Hiermee geeft u een optionele beschrijving op voor de assembly, die niet wordt weergegeven in de eigenschappen van Windows Verkenner
    Product Hiermee geeft u een productnaam voor de assembly op, die wordt weergegeven als de eigenschap Productnaam in eigenschappen van Windows Verkenner
    Bedrijf Hiermee geeft u een bedrijfsnaam op voor de assembly, die niet wordt weergegeven in de eigenschappen van Windows Verkenner
    Copyright Hiermee geeft u een copyrightmelding voor de assembly, die wordt weergegeven als Copyright in Windows Verkenner-eigenschappen
    Handelsmerk Hiermee geeft u een handelsmerk op voor de assembly, die wordt weergegeven als Juridische handelsmerken in Eigenschappen van Windows Verkenner
    Versie Hiermee geeft u de assemblyversie en bestandsversie op. Deze worden weergegeven in de eigenschappen van Windows Verkenner als Bestandsversie en Productversie.

    Het versienummer bestaat als volgt uit vier delen:

    <primaire versie>.< secundaire versie>.< buildnummer>.< Herziening>

  6. Selecteer OK wanneer u klaar bent met het invoeren van assemblygegevens.

  7. Selecteer Next. De pagina Opdrachten wordt weergegeven.

  8. Voeg een of meer opdrachten toe door de instructies in Opdrachten toevoegen aan een assembly te volgen.

  9. Wanneer u de definitie van uw activiteit hebt voltooid, selecteert u OK. Het dialoogvenster wordt gesloten en uw nieuwe activiteit wordt toegevoegd aan de lijst op de pagina Opdrachten . Als u terug wilt gaan en een opdracht wilt bewerken, selecteert u de opdracht in de lijst en selecteert u Bewerken. Als u een opdracht wilt verwijderen, selecteert u de opdracht in de lijst en selecteert u Verwijderen.

  10. Wanneer u klaar bent met het toevoegen en wijzigen van opdrachten, selecteert u Volgende. Het assemblybestand dat aan het begin van de wizard is opgegeven, wordt gecompileerd en wanneer het proces is voltooid, wordt de laatste wizardpagina weergegeven.

  11. Als u onmiddellijk een integratiepakket wilt maken vanuit deze nieuwe assembly, selecteert u de knop Integratiepakket bouwen , waarmee de wizard Integratiepakket wordt gestart en de informatie uit de assembly vooraf wordt geladen. Volg vervolgens de instructies in Een nieuw integratiepakket maken om het integratiepakket te maken.

  12. Als u uw assembly wilt testen met behulp van de .NET-activiteit aanroepen of het IP-buildproces voorlopig wilt overslaan, selecteert u Voltooien.

Opdrachten toevoegen aan een assembly

Een opdracht toevoegen aan een assembly

Volg deze stappen om een opdracht toe te voegen aan een assembly:

  1. Op de pagina Opdrachten kunt u een of meer opdrachten definiëren (die activiteiten worden) die aan de assembly worden toegevoegd. Als u een nieuwe opdracht wilt toevoegen, selecteert u Toevoegen.

  2. Het dialoogvenster Opdracht toevoegen/bewerken wordt weergegeven en bevat drie tabbladen: Algemeen, Argumenten en Gepubliceerde gegevens. Voer een naam in voor de opdracht. Dit wordt de naam die wordt weergegeven in Runbook Designer voor de activiteit. U kunt desgewenst ook een beschrijving voor de opdracht invoeren.

  3. De eigenschapskiezer Modus bevat vier opties: Opdracht uitvoeren, Windows PowerShell uitvoeren, Programma uitvoeren en SSH-opdracht uitvoeren. Als u de modus Programma uitvoeren hebt geselecteerd, wordt het veld Programma actief. Selecteer de knop met het beletselteken (...) en blader naar het programma dat u wilt uitvoeren.

    Notitie

    Het programma dat is geselecteerd in een opdracht Programma uitvoeren, wordt aangeroepen op de Runbook Server waarop het runbook met deze activiteit wordt uitgevoerd. Daarom moet dit programma bestaan op alle runbookservers waarop u verwacht het runbook uit te voeren.

  4. Selecteer het tabblad Argumenten .

  5. Typ in het veld Opdrachtregel de opdracht- of opdrachtregelparameters die nodig zijn voor uw activiteit. Als uw opdracht parameters bevat die gebruikers moeten opgeven, moet u deze toevoegen in de onderstaande lijst Parameters en vervolgens de knop Invoegen gebruiken om ze toe te voegen aan de opdrachtregel.

    Belangrijk

    Als u Uitvoeren Windows PowerShell hebt opgegeven voor de modus en u verwijst naar een PowerShell-script dat is opgenomen in uw integratiepakket, moet u de naam van het script voorafgaan met punt- en slashtekens om naar de lokale map te verwijzen. .\MyScript.ps1 wordt bijvoorbeeld opgegeven voor een script met de naam MyScript.ps1. Dit komt doordat het scriptbestand wordt gekopieerd naar de standaardmap voor het integratiepakket. Wanneer Windows PowerShell een script uitvoert vanuit de lokale map, moet deze notatie worden opgegeven.

  6. Als u parameters voor een opdrachtregel wilt opgeven, selecteert u Toevoegen. Het dialoogvenster Parameter toevoegen/bewerken wordt weergegeven.

  7. Typ in het veld Naam een naam voor de parameter die u toevoegt. Dit is de weergavenaam van de parameter die wordt weergegeven in de lijst Eigenschappen van de activiteit.

  8. Selecteer in de vervolgkeuzelijst Gebruiksmodus de modus die u voor de parameter wilt gebruiken. De gebruiksmodus heeft twee opties:

    Gebruiksmodus Beschrijving
    Opdrachtargument Selecteer dit argument als parameter in de opdrachtregel (met behulp van de knop Invoegen ). Een opdrachtargumentparameter met de naam Map kan bijvoorbeeld als volgt in de opdrachtregel worden geplaatst:

    Dir $(folder)Opmerking: Als opdrachtregelargumenten spaties bevatten (zoals mapnamen), moet u deze mogelijk tussen aanhalingstekens plaatsen om de opdracht goed te laten werken. Bijvoorbeeld: Dir "$(folder)"
    Omgevingsvariabele Selecteer om dit argument te gebruiken als een omgevingsvariabele die wordt ingesteld voordat de opdrachtregel wordt uitgevoerd. Het kan worden gebruikt als een opdrachtregelparameter of als een omgevingsvariabele binnen een script dat wordt uitgevoerd.

    Een omgevingsvariabeleparameter met de naam Map kan bijvoorbeeld als volgt in de opdrachtregel worden geplaatst:

    Dir %Folder%Belangrijk: De naam van de omgevingsvariabele bestaat al in gebruikers- of systeemomgevingen; de opdracht mislukt met een foutbericht dat er ongeveer als volgt uitziet: Item is al toegevoegd. Sleutel in woordenlijst: 'map' Sleutel die wordt toegevoegd: 'map'. U kunt bepalen welke omgevingsvariabelen op een lokale of externe computer bestaan door Start > Run te selecteren en te typen MSINFO32.EXE. Selecteer vervolgens Omgevingsvariabelen voor softwareomgeving>. Als u een andere computer wilt selecteren, drukt u op <Ctrl+R>, selecteert u Externe computer in het netwerk, voert u de computernaam in en selecteert u OK.

  9. Selecteer in de vervolgkeuzelijst Weergavestijl de stijl die u wilt gebruiken om de parameter weer te geven. De weergavestijl bepaalt hoe de gebruiker met de invoer communiceert wanneer deze aan de gebruiker wordt gepresenteerd. De keuzes worden hieronder beschreven:

    Weergavestijl Beschrijving
    Tekst De gebruiker krijgt een tekstvak in vrije vorm te zien voor het invoeren van een waarde
    Versleutelde tekst De gebruiker krijgt een gemaskeerd tekstvak te zien. De gegevens in dit veld worden versleuteld in de database en worden niet weergegeven in logboeken
    Waar/onwaar De gebruiker kan Waar of Onwaar selecteren in een pop-upvenster
    Tekst met selectie De gebruiker kan kiezen uit een groep opties die u opgeeft
    Datum/tijd De gebruiker kan de waarde selecteren met behulp van een besturingselement datum/tijdkiezer
    File De gebruiker kan de waarde selecteren met behulp van een besturingselement Bestandsbrowser
    Map De gebruiker kan de waarde selecteren met behulp van een mapbrowserbesturingselement
    Computer De gebruiker kan de waarde selecteren met behulp van een computerbrowserbesturingselement

  10. Als de parameter vereist of als u een standaardwaarde wilt opgeven, typt u deze in het veld Standaardwaarde .

  11. Als u Tekst met selectie hebt geselecteerd, wordt het veld Opties ingeschakeld. Als u optiewaarden wilt toevoegen waaruit de gebruiker kan kiezen, selecteert u de knop met het beletselteken naast het veld Opties en voert u deze in. Elke optie wordt op een afzonderlijke regel weergegeven. Wanneer u klaar bent met het toevoegen van opties, selecteert u OK.

  12. Wanneer u klaar bent met de parameterdefinitie, selecteert u OK.

  13. Als deze is gedefinieerd als een opdrachtparameter, kan de parameter nu worden toegevoegd aan de opdrachtregel door de cursor op de gewenste invoegpositie in de opdrachtregel te plaatsen, vervolgens de knop Invoegen te selecteren en de parameternaam te selecteren. Als deze is gedefinieerd als een omgevingsvariabele, moet u de variabele handmatig typen (in de indeling %variabele%) als u deze op de opdrachtregel wilt gebruiken.

  14. Als u de modi Programma uitvoeren of Opdrachtregel uitvoeren hebt gekozen, is het selectievakje voor de parameter Werkmap opnemen ingeschakeld.

  15. Selecteer het tabblad Gepubliceerde gegevens . Met de instellingen op dit tabblad kunt u uitvoergegevens publiceren naar de Orchestrator-gegevensbus, zodat andere activiteiten de informatie kunnen gebruiken.

  16. Als u een nieuwe eigenschap voor gepubliceerde gegevens wilt toevoegen, selecteert u Toevoegen.

  17. Als u de optie Opdracht uitvoeren, Programma uitvoeren of SSH-opdracht uitvoeren hebt geselecteerd in de vervolgkeuzelijst Modus op het tabblad Algemeen van het dialoogvenster Opdracht toevoegen/bewerken , worden de volgende items weergegeven in het dialoogvenster Gepubliceerde gegevens toevoegen/bewerken :

    Items Beschrijving
    Naam De weergavenaam van het gepubliceerde gegevensitem dat u maakt
    Bron De bron van het gepubliceerde gegevensitem. U kunt kiezen uit Standard Output Stream of Standard Error Stream vanaf de opdrachtregel
    Modus De modus die u wilt gebruiken om de gepubliceerde gegevens te selecteren.

    Gebruik Patroon vergelijken om te bepalen of een bepaald patroon wordt gevonden in de bron. Dit retourneert True of False.

    Groep extraheren gebruiken om elk gegevensitem op te halen dat overeenkomt met het patroon dat u opgeeft
    Patroon De reguliere expressie die van toepassing is op de instelling Modus
    Beschrijving De beschrijvingstekst die wordt weergegeven naast de eigenschap gepubliceerde gegevens in Runbook Designer. (optioneel)

  18. Als u de optie Windows PowerShell uitvoeren hebt geselecteerd in de vervolgkeuzelijst Modus op het tabblad Algemeen van het dialoogvenster Opdracht toevoegen/bewerken, worden de volgende items weergegeven in het dialoogvenster Gepubliceerde gegevens toevoegen/bewerken:

    Items Beschrijving
    Naam De weergavenaam van het gepubliceerde gegevensitem dat u maakt
    Eigenschap De naam van de eigenschap Windows PowerShell die wordt opgeslagen in het gepubliceerde gegevensitem. Deze eigenschap moet zijn opgenomen in een objectuitvoer naar de PowerShell-pijplijn tijdens het script en mag geen object zijn (moet kunnen worden geconverteerd naar een tekenreeks).
    Beschrijving De beschrijvingstekst die wordt weergegeven naast de eigenschap gepubliceerde gegevens in Runbook Designer. (optioneel)

  19. Selecteer OK om het toevoegen van het item Gepubliceerde gegevens te voltooien. Herhaal stap 16-18 voor elk gepubliceerde gegevensitem dat u wilt toevoegen.

  20. Selecteer OK om het dialoogvenster Opdracht toevoegen/bewerken te sluiten en terug te keren naar het dialoogvenster Opdrachten.

Een activiteitsassembly testen

Nadat u een assembly hebt gemaakt, kunt u deze testen met behulp van de .NET-activiteit aanroepen (in het IP-adres van integration toolkit voor .NET) om te controleren of deze werkt zoals verwacht voordat u deze converteert naar een aangepast integratiepakket.

Een assembly testen

Volg deze stappen om een assembly te testen:

  1. Open the Runbook Designer.

  2. Maak een nieuw runbook.

  3. Selecteer in het deelvenster Activiteiten de categorie Integration Toolkit om deze uit te vouwen en sleep een .NET-activiteit aanroepen naar het nieuwe runbook.

  4. Dubbelklik op het .NET-object aanroepen om het dialoogvenster Eigenschappen weer te geven.

  5. Blader in het veld Assembly naar het assemblybestand dat u hebt gemaakt met behulp van de wizard Command-Line activiteit (of via aangepaste ontwikkeling met behulp van de SDK) door de knop met het beletselteken (...) rechts van het veld te selecteren. Selecteer het bestand en selecteer Openen.

  6. Selecteer de knop met het beletselteken rechts van het veld Klasse om een lijst met de afzonderlijke opdrachten in de assembly weer te geven. Selecteer een opdrachtklasse en selecteer OK. Parameters voor deze klasse worden weergegeven op het tabblad Eigenschappen van het dialoogvenster.

  7. Het veld Setup wordt alleen gebruikt door aangepaste klassen met behulp van de Orchestrator SDK met het kenmerk OrchestratorData. Zie System Center Orchestrator Integration Toolkit SDK voor meer informatie over de SDK.

  8. Selecteer het tabblad Properties.

  9. Geef indien nodig de informatie voor elk van de eigenschappen op.

  10. Selecteer Voltooien om de instellingen op te slaan en terug te keren naar het runbook.

  11. Selecteer Runbook Tester op de werkbalk in Runbook Designer. Runbook Tester wordt gestart.

  12. Selecteer Uitvoeren naar onderbrekingspunt op de werkbalk. Het runbook wordt gestart en uw activiteit wordt uitgevoerd. De resultaten van de activiteit worden weergegeven in het deelvenster Logboek uitvoeren .

  13. Selecteer Details weergeven onder de naam van de activiteit in het deelvenster Logboek uitvoeren om de gedetailleerde resultaten te bekijken, inclusief de invoereigenschappen en gepubliceerde gegevens.

Migratie van QIK CLI-activiteit

Als u een assembly hebt die is gemaakt met behulp van de Opalis 6.3 QIK CLI-wizard, moet u deze converteren om compatibel te zijn met Orchestrator voordat deze kan worden gebruikt in een Orchestrator-integratiepakket of rechtstreeks in runbooks kan worden gebruikt via de activiteit .NET aanroepen. Het conversieproces is eenvoudig en duurt slechts een paar seconden per montage.

Belangrijk

De installatie van de Orchestrator Integration Toolkit mislukt niet als Microsoft .NET Framework 3.5, Service Pack 1 niet is geïnstalleerd, maar verschillende bewerkingen in de wizard Command-Line-activiteit mislukken als deze niet aanwezig is. Zorg ervoor dat Microsoft .NET Framework 3.5, Service Pack 1 is geïnstalleerd voordat u de CLI gebruikt.

Een Opalis QIK CLI-assembly converteren

Volg deze stappen om een Opalis QIK CLI-assembly te converteren:

  1. Start de wizard Orchestrator Command-Line-activiteit door Alle > programma's > starten Microsoft System Center 2012 > Orchestrator > Command-Line Activity Wizard te selecteren

  2. Wanneer de wizard wordt geladen, selecteert u de knop Bestaande assembly laden op de eerste pagina.

  3. Selecteer uw bestaande assemblybestand en selecteer vervolgens Openen. De naam en bestandslocatie van de assembly worden weergegeven.

  4. Wijzig het bestandspad zodat de wijzigingen worden opgeslagen in een nieuw bestand. U kunt indien nodig ook de naam van de assembly wijzigen.

  5. Als u verdere wijzigingen wilt aanbrengen in de details van de assembly-gegevens, selecteert u de knop Assembly-gegevens en voert u deze wijzigingen aan. Selecteer OK wanneer u klaar bent om terug te keren naar de pagina Assembly-details.

  6. Selecteer Volgende om naar de pagina Opdrachten te gaan. U ziet nu een lijst met opdrachten die eerder zijn gedefinieerd in de assembly. Controleer indien nodig de opdrachten en selecteer Volgende om door te gaan naar de pagina Bouwassembly .

  7. De nieuwe assembly wordt voor u gemaakt en opgeslagen met behulp van het pad en de bestandsnaam die u eerder hebt gedefinieerd.

  8. U kunt nu uw nieuwe Orchestrator-compatibele assembly gebruiken in runbooks met de activiteit .NET aanroepen, of u kunt een integratiepakket maken vanuit deze assembly door de knop Integratiepakket bouwen te selecteren. Als u op dit moment geen IP-adres wilt maken, selecteert u Sluiten om de wizard te beëindigen.

Orchestrator-resources

Naast deze online referentie voor System Center 2012 Orchestrator, zijn er een aantal bronnen die aanvullende informatie kunnen bieden over het bouwen van runbooks, het gebruik van de Integration Toolkit en best practices.