Condividi tramite

Creazione guidata attività della riga di comando

  • Articolo

L'Attività guidata riga di comando consente di creare rapidamente nuove attività in Orchestrator incapsulando comandi, argomenti e parametri in un assembly Microsoft .NET (.DLL). La procedura guidata crea automaticamente il codice sorgente C# usando Orchestrator SDK e lo compila automaticamente. Usando questo assembly, è possibile usare .NET Integration Pack (parte di Integration Toolkit) per testare le attività e quindi usare la Creazione guidata Integration Pack per creare un pacchetto dell'assembly in un Integration Pack personalizzato che può essere distribuito e distribuito esattamente come altri Integration Pack.

Un assembly può contenere una o più attività (comandi) e le attività possono essere uno o più dei tipi di comando disponibili (comando, riga di comando, powerShell o comando SSH). È possibile definire il nome dell'attività, la struttura dei comandi, i parametri di input e persino i dati pubblicati (output).

Panoramica delle attività in Orchestrator

Un'attività è una singola parte funzionale di un runbook di Orchestrator. Le attività sono le operazioni effettive all'interno dei runbook e vengono unite insieme usando collegamenti che possono essere definiti con condizioni per creare rami del flusso di lavoro. Quando si compila un runbook usando Runbook Designer, trascinare e rilasciare attività dal riquadro Attività nel runbook e collegarle insieme per formare il flusso di lavoro. Durante l'esecuzione del runbook, richiama ogni attività in sequenza in base alla modalità di collegamento. Ogni attività esegue un compito specifico e può raccogliere dati di input dal bus di dati di Orchestrator e pubblicarne l'output nello stesso bus di dati. Ogni attività ha la possibilità di disegnare dati pubblicati da qualsiasi attività eseguita prima del runbook e la pubblicazione dei dati di output consente alle attività seguenti di accedervi.

Le attività vanno da semplice a complessa. È possibile creare un'attività usando l'Attività guidata riga di comando che non esegue alcuna operazione, ma restituisce testo a una proprietà di output. È anche possibile creare una singola attività che esegue un'azione complessa in più passaggi, ad esempio la distribuzione di macchine virtuali. Spetta a te definire le operazioni che ogni attività eseguirà. Tuttavia, l'obiettivo deve essere quello di definire attività che incapsulano singoli set di funzionalità che consentono di riutilizzare facilmente in molti tipi diversi di situazioni. La chiave è la flessibilità. È preferibile creare un set di 10 attività diverse, ognuna delle quali fa qualcosa di specifico e può usare tali attività in 20 modi diversi, anziché creare 20 attività diverse per risolvere i singoli scenari specifici. Altre informazioni sulle procedure consigliate sono illustrate più avanti in questo documento.

Creare un nuovo assembly attività

Seguire questa procedura per creare un nuovo assembly di attività della riga di comando:

  1. Selezionare Avvia > tutti i programmi > Microsoft System Center 2012 > Orchestrator Integration Toolkit > Orchestrator > Command-Line Activity Wizard

  2. Selezionare Avanti.

  3. Nella pagina Dettagli assembly immettere un valore per Nome che inizia con una lettera e viene seguito da zero o più caratteri alfanumerici. Questo nome viene usato come identificatore dello spazio dei nomi C# per l'assembly e le attività.

  4. In File di assembly immettere un percorso e un nome file del file di assembly che verrà creato da questa procedura guidata. Se il file esiste già, verrà richiesto di sovrascrivere il file.

  5. Selezionare Informazioni assembly. È possibile immettere le informazioni qui che diventeranno le proprietà del file di assembly, visibili in Esplora risorse tramite le proprietà dei file. I valori delle proprietà sono definiti nella tabella seguente. Queste informazioni sono facoltative e non sono necessarie per compilare un assembly.

    Proprietà Descrizione
    Posizione Specifica un titolo per l'assembly, che viene visualizzato come proprietà Descrizione file nelle proprietà di Esplora risorse
    Descrizione Specifica una descrizione facoltativa per l'assembly, che non viene visualizzata nelle proprietà di Esplora risorse
    Prodotto Specifica un nome di prodotto per l'assembly, che viene visualizzato come proprietà Product name nelle proprietà di Esplora risorse
    Company Specifica un nome della società per l'assembly, che non viene visualizzato nelle proprietà di Esplora risorse
    Copyright Specifica un avviso sul copyright per l'assembly, che viene visualizzato come copyright nelle proprietà di Esplora risorse
    Marchio Specifica un marchio per l'assembly, che viene visualizzato come marchi legali nelle proprietà di Esplora risorse
    Versione Specifica la versione dell'assembly e la versione del file. Questi elementi vengono visualizzati nelle proprietà di Esplora risorse come Versione file e Versione prodotto.

    Il numero di versione ha quattro parti come indicato di seguito:

    <versione principale>.<versione secondaria>.<numero di build>.<revisione>

  6. Al termine dell'immissione delle informazioni sull'assembly, selezionare OK .

  7. Selezionare Avanti. Viene visualizzata la pagina Comandi .

  8. Aggiungere uno o più comandi seguendo le istruzioni fornite in Aggiungere comandi a un assembly.

  9. Dopo aver completato la definizione dell'attività, selezionare OK. La finestra di dialogo si chiude e la nuova attività viene aggiunta all'elenco nella pagina Comandi . Se è necessario tornare indietro e modificare un comando, selezionare il comando nell'elenco e selezionare Modifica. Se è necessario eliminare un comando, selezionare il comando nell'elenco e selezionare Rimuovi.

  10. Al termine dell'aggiunta e della modifica dei comandi, selezionare Avanti. Il file di assembly specificato all'inizio della procedura guidata viene compilato e, al termine del processo, viene visualizzata la pagina finale della procedura guidata.

  11. Per compilare immediatamente un Integration Pack da questo nuovo assembly, selezionare il pulsante Compila Integration Pack , che avvia la Creazione guidata Integration Pack e pre-carica le informazioni dall'assembly. Seguire quindi le istruzioni riportate in Creazione di un nuovo Integration Pack per creare il Integration Pack.

  12. Per testare l'assembly usando l'attività Invoke .NET o ignorare il processo di compilazione IP per il momento, selezionare Fine.

Aggiungere comandi a un assembly

Seguire questa procedura per aggiungere un comando a un assembly:

  1. Nella pagina Comandi è possibile definire uno o più comandi (che diventano attività) che verranno aggiunti all'assembly. Per aggiungere un nuovo comando, selezionare Aggiungi.

  2. La finestra di dialogo Aggiungi/Modifica comando visualizza e contiene tre schede: Generale, Argomenti e Dati pubblicati. Immetti un Nome per il comando. Questo diventa il nome visualizzato in Runbook Designer per l'attività. Facoltativamente, è possibile immettere anche una descrizione per il comando.

  3. Il selettore di proprietà Mode contiene quattro opzioni: Esegui comando, Esegui Windows PowerShell, Esegui programma ed Esegui comando SSH. Se è stata selezionata la modalità Esegui programma , il campo Programma diventa attivo. Selezionare il pulsante con i puntini di sospensione (...) e cercare il programma da eseguire.

    Nota

    Il programma selezionato in un comando Esegui programma verrà richiamato nel server Runbook in cui viene eseguita l'attività nel runbook contenente questa attività. Pertanto, questo programma deve esistere in tutti i server Runbook in cui si prevede di eseguire il runbook.

  4. Selezionare la scheda Argomenti .

  5. Nel campo Riga di comando digitare i parametri del comando o della riga di comando necessari per l'attività. Se il comando accetta parametri da specificare dagli utenti, sarà necessario aggiungerli nell'elenco Parametri riportato di seguito e quindi usare il pulsante Inserisci per aggiungerli alla riga di comando.

    Importante

    Se è stato specificato Esegui Windows PowerShell per la modalità e si fa riferimento a uno script di PowerShell incluso nel Integration Pack, è necessario precedere il nome dello script con caratteri punto e barra per fare riferimento alla directory locale. Ad esempio, .\MyScript.ps1 viene specificato per uno script denominato MyScript.ps1. Questo perché il file di script verrà copiato nella directory predefinita per Integration Pack. Quando Windows PowerShell esegue uno script dalla directory locale, deve specificare questa notazione.

  6. Per specificare i parametri per una riga di comando, selezionare Aggiungi. Verrà visualizzata la finestra di dialogo Aggiungi/Modifica parametro .

  7. Nel campo Nome digitare un nome per il parametro che si sta aggiungendo. Si tratta del nome visualizzato del parametro visualizzato nell'elenco Proprietà dell'attività.

  8. Nell'elenco a discesa Modalità di utilizzo selezionare la modalità che verrà usata per il parametro . La modalità Utilizzo include due opzioni:

    Modalità di utilizzo Descrizione
    Argomento del comando Selezionare questa opzione per usare questo argomento come parametro all'interno della riga di comando (usando il pulsante Inserisci ). Ad esempio, un parametro dell'argomento di comando denominato "Folder" può essere inserito nella riga di comando come segue:

    Dir $(folder)Nota: Se gli argomenti della riga di comando contengono spazi, ad esempio i nomi delle cartelle, potrebbe essere necessario racchiuderli tra virgolette per il corretto funzionamento del comando. Ad esempio: Dir "$(folder)"
    Variabile di ambiente Selezionare questa opzione per usare questo argomento come variabile di ambiente che verrà impostata prima dell'esecuzione della riga di comando. Può essere usato come parametro della riga di comando o come variabile di ambiente all'interno di uno script eseguito.

    Ad esempio, un parametro di variabile di ambiente denominato "Folder" può essere inserito nella riga di comando come segue:

    Dir %Folder%Importante: Il nome della variabile di ambiente esiste già in ambienti utente o di sistema; Il comando avrà esito negativo con un messaggio di errore simile al seguente: l'elemento è già stato aggiunto. Chiave nel dizionario: 'folder' Chiave da aggiungere: 'folder'. È possibile determinare quali variabili di ambiente esistono in un computer locale o remoto selezionando Avvia > esecuzione e digitando MSINFO32.EXE. Selezionare quindi Variabili di ambiente > software. Per selezionare un altro computer, premere <CTRL+R>, selezionare Computer remoto in rete, immettere il nome del computer e selezionare OK.

  9. Nell'elenco a discesa Stile di visualizzazione selezionare lo stile che verrà usato per visualizzare il parametro. Lo stile di visualizzazione determina la modalità di interazione dell'utente con l'input quando viene presentato. Le scelte sono descritte di seguito:

    Stile di visualizzazione Descrizione
    Testo L'utente verrà visualizzato con una casella di testo in formato libero per l'immissione di un valore
    Testo crittografato L'utente verrà visualizzato con una casella di testo mascherata. I dati in questo campo verranno crittografati all'interno del database e non verranno visualizzati in alcun log
    Vero/Falso L'utente può selezionare True o False da una finestra di dialogo popup
    Testo con selezione L'utente può selezionare da un gruppo di opzioni specificate
    Data/ora L'utente può selezionare il valore usando un controllo Selezione data/ora
    file L'utente può selezionare il valore usando un controllo Browser file
    Cartella L'utente può selezionare il valore usando un controllo Visualizzatore cartelle
    Computer L'utente può selezionare il valore usando un controllo Browser computer

  10. Se il parametro richiede o si desidera specificare un valore predefinito, digitarlo nel campo Valore predefinito.

  11. Se è stato selezionato Testo con selezione, il campo Opzioni è abilitato. Per aggiungere valori di opzione tra cui l'utente può selezionare, selezionare il pulsante con i puntini di sospensione accanto al campo Opzioni e immetterli. Ogni opzione è elencata in una riga separata. Al termine dell'aggiunta di opzioni, selezionare OK.

  12. Al termine della definizione del parametro, selezionare OK.

  13. Se definito come parametro di comando, il parametro può ora essere aggiunto alla riga di comando posizionando il cursore nel punto di inserimento desiderato nella riga di comando, quindi selezionando il pulsante Inserisci e selezionando il nome del parametro. Se definito come variabile di ambiente, è necessario digitare manualmente nella variabile (nel formato %variabile%) se lo si desidera nella riga di comando.

  14. Se si sceglie la modalità Esegui programma o Esegui riga di comando , la casella di controllo Includi parametro directory di lavoro è abilitato.

  15. Selezionare la scheda Dati pubblicati. Le impostazioni di questa scheda consentono di pubblicare i dati di output nel bus di dati di Orchestrator in modo che altre attività possano utilizzare le informazioni.

  16. Per aggiungere una nuova proprietà di dati pubblicata, selezionare Aggiungi.

  17. Se è stata selezionata l'opzione Esegui comando, Esegui programma o Esegui comando SSH dall'elenco a discesa Modalità della scheda Generale della finestra di dialogo Aggiungi/Modifica comando, nella finestra di dialogo Aggiungi/Modifica dati pubblicati vengono visualizzati gli elementi seguenti:

    Articoli Descrizione
    Name Nome visualizzato dell'elemento dati pubblicato che si sta creando
    Origine Origine dell'elemento Dati pubblicati. È possibile scegliere tra flusso di output standard o flusso di errore standard dalla riga di comando
    Modalità Modalità da usare per selezionare i dati pubblicati.

    Usare Modello di corrispondenza per determinare se un determinato criterio viene trovato all'interno dell'origine. Verrà restituito True o False.

    Usare Extract Group per recuperare ogni elemento di dati corrispondente al modello specificato
    Modello Espressione regolare che si applica all'impostazione Mode
    Descrizione Testo della descrizione visualizzato accanto alla proprietà dei dati pubblicati in Runbook Designer. (facoltativo).

  18. Se è stata selezionata l'opzione Esegui Windows PowerShell dall'elenco a discesa Modalità della scheda Generale della finestra di dialogo Aggiungi/Modifica comando, nella finestra di dialogo Aggiungi/Modifica dati pubblicati vengono visualizzati gli elementi seguenti:

    Articoli Descrizione
    Name Nome visualizzato dell'elemento dati pubblicato che si sta creando
    Proprietà Nome della proprietà di Windows PowerShell che verrà salvata nell'elemento Dati pubblicati. Questa proprietà deve essere contenuta in un output dell'oggetto nella pipeline di PowerShell durante lo script e non deve essere un oggetto (deve essere in grado di essere convertito in una stringa).
    Descrizione Testo della descrizione visualizzato accanto alla proprietà dei dati pubblicati in Runbook Designer. (facoltativo).

  19. Selezionare OK per completare l'aggiunta dell'elemento Dati pubblicati. Ripetere i passaggi da 16 a 18 per ogni elemento di dati pubblicato da aggiungere.

  20. Selezionare OK per chiudere la finestra di dialogo Aggiungi/Modifica comando e tornare alla finestra di dialogo Comandi.

Testare un assembly di attività

Dopo aver creato un assembly, è possibile testarlo usando l'attività Invoke .NET (contenuta in Integration Toolkit IP for .NET) per verificare che funzioni come previsto prima di convertirlo in un Integration Pack personalizzato.

Testare un assembly

Per testare un assembly, seguire questa procedura:

  1. Aprire Runbook Designer.

  2. Creare un nuovo Runbook.

  3. Nel riquadro Attività selezionare la categoria Integration Toolkit per espanderla e trascinare un'attività Invoke .NET nel nuovo runbook.

  4. Fare doppio clic sull'oggetto Invoke .NET per visualizzare la finestra di dialogo Proprietà .

  5. Nel campo Assembly cercare il file di assembly creato usando l'Activity Wizard della riga di comando (o tramite sviluppo personalizzato tramite l'SDK) selezionando il pulsante con i puntini di sospensione (...) a destra del campo. Selezionare il file e selezionare Apri.

  6. Selezionare il pulsante con i puntini di sospensione a destra del campo Classe per visualizzare un elenco dei singoli comandi nell'assembly. Selezionare una classe di comando e selezionare OK. I parametri per questa classe vengono visualizzati nella scheda Proprietà della finestra di dialogo.

  7. Il campo Setup viene usato solo dalle classi sviluppate personalizzata usando Orchestrator SDK con l'attributo OrchestratorData. Per altre informazioni sull'SDK, vedere System Center Orchestrator Integration Toolkit SDK.

  8. Seleziona la scheda Proprietà.

  9. Specificare le informazioni per ognuna delle proprietà in base alle esigenze.

  10. Selezionare Fine per salvare le impostazioni e tornare al runbook.

  11. Selezionare Runbook Tester nella barra degli strumenti di Runbook Designer. Viene avviato il tester del runbook.

  12. Selezionare Esegui fino a punto di interruzione nella barra degli strumenti. Viene avviato il runbook e l'attività viene eseguita. I risultati dell'attività vengono visualizzati nel riquadro Esegui log .

  13. Selezionare Mostra dettagli sotto il nome dell'attività nel riquadro Esegui log per visualizzare i risultati dettagliati, incluse le proprietà di input e i dati pubblicati.

Migrazione dell'attività dell'interfaccia della riga di comando di QIK

Se è stato creato un assembly che usa l'Interfaccia guidata interfaccia della riga di comando di Opalis 6.3 QIK, sarà necessario convertirlo in modo che sia compatibile con Orchestrator prima di poterlo usare in un Integration Pack di Orchestrator o usato direttamente nei runbook tramite l'attività Invoke .NET. Il processo di conversione è semplice e richiede solo pochi secondi per assembly.

Importante

L'installazione di Orchestrator Integration Toolkit non avrà esito negativo se Microsoft .NET Framework 3.5, Service Pack 1 non è installato, ma le diverse operazioni della Creazione guidata attività della riga di comando avranno esito negativo se non è presente. Assicurarsi che Microsoft .NET Framework 3.5, Service Pack 1 sia installato prima di usare l'interfaccia della riga di comando.

Convertire un assembly dell'interfaccia della riga di comando di Opalis QIK

Seguire questa procedura per convertire un assembly dell'interfaccia della riga di comando di Opalis QIK:

  1. Avviare l'Attività guidata della riga di comando di Orchestrator selezionando Avvia > tutti i programmi > Microsoft System Center 2012 > Orchestrator > Command Line Activity Wizard

  2. Al caricamento della procedura guidata, selezionare il pulsante Carica assembly esistente nella prima pagina.

  3. Selezionare il file di assembly esistente e quindi selezionare Apri. Viene visualizzato il nome e il percorso del file dell'assembly.

  4. Modificare il percorso del file in modo che le modifiche vengano salvate in un nuovo file. Se necessario, è anche possibile modificare il nome dell'assembly.

  5. Se è necessario apportare ulteriori modifiche ai dettagli delle informazioni sull'assembly, selezionare il pulsante Informazioni assembly e apportare tali modifiche. Selezionare OK al termine per tornare alla pagina Dettagli assembly.

  6. Selezionare Avanti per passare alla pagina Comandi. Verrà visualizzato un elenco di comandi definiti in precedenza nell'assembly. Esaminare i comandi, se necessario, e selezionare Avanti per passare alla pagina Compilazione assembly .

  7. Il nuovo assembly verrà compilato automaticamente e salvato usando il percorso e il nome file definiti in precedenza.

  8. È ora possibile usare il nuovo assembly compatibile con Orchestrator nei runbook con l'attività Invoke .NET oppure compilare un Integration Pack da questo assembly selezionando il pulsante Compila Integration Pack . Se non si vuole creare un indirizzo IP in questo momento, selezionare Chiudi per terminare la procedura guidata.

Risorse di Orchestrator

Oltre a questo riferimento online fornito per System Center 2012 Orchestrator, sono disponibili numerose risorse che possono fornire informazioni aggiuntive sulla compilazione di runbook, usando Integration Toolkit e le procedure consigliate.