Migrazione da Orchestrator ad Automazione di Azure (Beta)Migrating from Orchestrator to Azure Automation (Beta)

I runbook in System Center Orchestrator si basano su attività di Integration Pack scritte appositamente per Orchestrator, mentre i runbook di Automazione di Azure si basano su Windows PowerShell.Runbooks in System Center Orchestrator are based on activities from integration packs that are written specifically for Orchestrator while runbooks in Azure Automation are based on Windows PowerShell. Runbook grafici di Automazione di Azure hanno un aspetto simile ai runbook di Orchestrator con attività che rappresentano i cmdlet di PowerShell, i runbook figlio e gli asset.Graphical runbooks in Azure Automation have a similar appearance to Orchestrator runbooks with their activities representing PowerShell cmdlets, child runbooks, and assets.

System Center Orchestrator Migration Toolkit include strumenti che facilitano la conversione dei runbook da Orchestrator ad Automazione di Azure.The System Center Orchestrator Migration Toolkit includes tools to assist you in converting runbooks from Orchestrator to Azure Automation. Oltre ai runbook stessi, è necessario convertire gli Integration Pack con le attività usate dai runbook in moduli di integrazione con cmdlet di Windows PowerShell.In addition to converting the runbooks themselves, you must convert the integration packs with the activities that the runbooks use to integration modules with Windows PowerShell cmdlets.

Di seguito è illustrato il processo di base per la conversione di runbook di Orchestrator in Automazione di Azure.Following is the basic process for converting Orchestrator runbooks to Azure Automation. Ognuno di questi passaggi viene descritto nei dettagli nelle sezioni seguenti.Each of these steps is described in detail in the sections below.

  1. Scaricare System Center Orchestrator Migration Toolkit , che contiene gli strumenti e i moduli descritti in questo articolo.Download the System Center Orchestrator Migration Toolkit which contains the tools and modules discussed in this article.
  2. Importare il modulo delle attività standard in Automazione di Azure.Import Standard Activities Module into Azure Automation. Questo modulo include versioni convertite di attività standard di Orchestrator che possono essere usate dai runbook convertiti.This includes converted versions of standard Orchestrator activities that may be used by converted runbooks.
  3. Importare i moduli di integrazione di System Center Orchestrator in Automazione di Azure per gli Integration Pack usati dai runbook che accedono a System Center.Import System Center Orchestrator Integration Modules into Azure Automation for those integration packs used by your runbooks that access System Center.
  4. Convertire gli Integration Pack personalizzati e di terze parti mediante Integration Pack Converter e importarli in Automazione di Azure.Convert custom and third party integration packs using the Integration Pack Converter and import into Azure Automation.
  5. Convertire i runbook di Orchestrator usando Runbook Converter e installarli in Automazione di Azure.Convert Orchestrator runbooks using the Runbook Converter and install in Azure Automation.
  6. Creare manualmente gli asset di Orchestrator necessari in Automazione di Azure, poiché Runbook Converter non converte queste risorse.Manually create required Orchestrator assets in Azure Automation since the Runbook Converter does not convert these resources.
  7. Configurare un ruolo di lavoro ibrido per runbook nel data center locale per eseguire i runbook convertiti che accedono alle risorse locali.Configure a Hybrid Runbook Worker in your local data center to run converted runbooks that will access local resources.

Service Management AutomationService Management Automation

Service Management Automation (SMA) archivia ed esegue i runbook nel data center locale come Orchestrator e usa gli stessi moduli di integrazione di Automazione di Azure.Service Management Automation (SMA) stores and runs runbooks in your local data center like Orchestrator, and it uses the same integration modules as Azure Automation. Runbook Converter converte i runbook di Orchestrator in runbook grafici, che non sono supportati in SMA.The Runbook Converter converts Orchestrator runbooks to graphical runbooks though which are not supported in SMA. È comunque possibile installare il modulo delle attività standard e i moduli di integrazione di System Center Orchestrator in SMA, ma in tal caso è necessario riscrivere i runbook manualmente.You can still install the Standard Activities Module and System Center Orchestrator Integration Modules into SMA, but you must manually rewrite your runbooks.

ruolo di lavoro ibrido per runbookHybrid Runbook Worker

I runbook in Orchestrator sono archiviati in un server di database e vengono eseguiti in server runbook, tutti contenuti nel data center locale.Runbooks in Orchestrator are stored on a database server and run on runbook servers, both in your local data center. I runbook in Automazione di Azure sono archiviati nel cloud Azure e possono essere eseguiti nel data center locale tramite un computer Hybrid Runbook Worker.Runbooks in Azure Automation are stored in the Azure cloud and can run in your local data center using a Hybrid Runbook Worker. Questo è il modo in cui verranno eseguiti in genere i runbook convertiti da Orchestrator poiché sono designati per l'esecuzione in server locali.This is how you will usually run runbooks converted from Orchestrator since they are designed to run on local servers.

Integration Pack ConverterIntegration Pack Converter

Integration Pack Converter converte gli Integration Pack creati mediante Orchestrator Integration Toolkit (OIT) in moduli di integrazione basati su Windows PowerShell che possono essere importati in Automazione di Azure o in Service Management Automation.The Integration Pack Converter converts integration packs that were created using the Orchestrator Integration Toolkit (OIT) to integration modules based on Windows PowerShell that can be imported into Azure Automation or Service Management Automation.

Quando si esegue Integration Pack Converter, viene visualizzata una procedura guidata che consente di selezionare un file Integration Pack (con estensione oip).When you run the Integration Pack Converter, you are presented with a wizard that will allow you to select an integration pack (.oip) file. La procedura guidata elenca quindi le attività incluse nell'Integration Pack e consente di selezionare quella da sottoporre a migrazione.The wizard then lists the activities included in that integration pack and allows you to select which will be migrated. Al termine della procedura guidata, viene creato un modulo di integrazione che include un cmdlet corrispondente per ogni attività dell'Integration Pack originale.When you complete the wizard, it creates an integration module that includes a corresponding cmdlet for each of the activities in the original integration pack.

ParametriParameters

Tutte le proprietà di un'attività dell'Integration Pack vengono convertite in parametri del cmdlet corrispondente nel modulo di integrazione.Any properties of an activity in the integration pack are converted to parameters of the corresponding cmdlet in the integration module. I cmdlet di Windows PowerShell dispongono di un set di parametri comuni che possono essere usati con tutti i cmdlet.Windows PowerShell cmdlets have a set of common parameters that can be used with all cmdlets. Con il parametro -Verbose ad esempio un cmdlet restituisce informazioni dettagliate sul proprio funzionamento.For example, the -Verbose parameter causes a cmdlet to output detailed information about its operation. Nessun cmdlet può usare un parametro con lo stesso nome di un parametro comune.No cmdlet may have a parameter with the same name as a common parameter. Se un'attività dispone di una proprietà con lo stesso nome del parametro comune, la procedura guidata chiederà di specificare un altro nome per il parametro.If an activity does have a property with the same name as a common parameter, the wizard will prompt you to provide another name for the parameter.

Attività di monitoraggioMonitor activities

I runbook di monitoraggio in Orchestrator iniziano con un' attività di monitoraggio e vengono eseguiti in modo continuativo in attesa di essere richiamati da un evento specifico.Monitor runbooks in Orchestrator start with a monitor activity and run continuously waiting to be invoked by a particular event. Automazione di Azure non supporta i runbook di monitoraggio, pertanto le attività di monitoraggio nell'Integration Pack non verranno convertite.Azure Automation does not support monitor runbooks, so any monitor activities in the integration pack will not be converted. Nel modulo di integrazione verrà creato invece un cmdlet segnaposto per l'attività di monitoraggio.Instead, a placeholder cmdlet is created in the integration module for the monitor activity. Questo cmdlet è privo di funzionalità, ma consente l'installazione dei runbook convertiti che lo usano.This cmdlet has no functionality, but it allows any converted runbook that uses it to be installed. Questo runbook non potrà essere eseguito in Automazione di Azure, ma può essere installato in modo che l'utente possa modificarlo.This runbook will not be able to run in Azure Automation, but it can be installed so that you can modify it.

Integration Pack che non possono essere convertitiIntegration packs that cannot be converted

Gli Integration Pack non creati con OIT non possono essere convertiti con Integration Pack Converter.Integration packs that were not created with OIT cannot be converted with the Integration Pack Converter. Esistono anche alcuni Integration Pack di Microsoft che attualmente non è possibile convertire con questo strumento.There are also some integration packs provided by Microsoft that cannot currently be converted with this tool. Le versioni convertite di questi Integration Pack sono disponibili per il download , in modo da poterle installare in Automazione di Azure o in Service Management Automation.Converted versions of these integration packs have been provided for download so that they can be installed in Azure Automation or Service Management Automation.

modulo delle attività standardStandard Activities Module

Orchestrator contiene un insieme di attività standard non incluse in un Integration Pack, ma usate da molti runbook.Orchestrator includes a set of standard activities that are not included in an integration pack but are used by many runbooks. Il modulo delle attività standard è un modulo di integrazione che include un cmdlet equivalente per ognuna di queste attività.The Standard Activities module is an integration module that includes a cmdlet equivalent for each of these activities. È necessario installare questo modulo di integrazione in Automazione di Azure prima di importare eventuali runbook convertiti che usano un'attività standard.You must install this integration module in Azure Automation before importing any converted runbooks that use a standard activity.

Oltre a supportare i runbook convertiti, i cmdlet del modulo delle attività standard possono essere usati da chiunque abbia familiarità con Orchestrator per creare nuovi runbook in Automazione di Azure.In addition to supporting converted runbooks, the cmdlets in the standard activities module can be used by someone familiar with Orchestrator to build new runbooks in Azure Automation. Benché le funzionalità di tutte le attività standard possano essere eseguite con i cmdlet, è possibile che funzionino in modo diverso.While the functionality of all of the standard activities can be performed with cmdlets, they may operate differently. I cmdlet nel modulo delle attività standard convertite funzioneranno come le attività corrispondenti e useranno gli stessi parametri.The cmdlets in the converted standard activities module will work the same as their corresponding activities and use the same parameters. Questo può rivelarsi utile per l'autore del runbook di Orchestrator esistente nella transizione ai runbook di Automazione di Azure.This can help the existing Orchestrator runbook author in their transition to Azure Automation runbooks.

moduli di integrazione di System Center OrchestratorSystem Center Orchestrator Integration Modules

Microsoft mette a disposizione Integration Pack per la creazione di runbook per l'automatizzazione di componenti di System Center e altri prodotti.Microsoft provides integration packs for building runbooks to automate System Center components and other products. Alcuni degli Integration Pack attualmente sono basati su OIT ma non possono essere convertiti in moduli di integrazione a causa di problemi noti.Some of these integration packs are currently based on OIT but cannot currently be converted to integration modules because of known issues. moduli di integrazione di System Center Orchestrator includono versioni convertite degli Integration Pack che possono essere importate in Automazione di Azure e in Service Management Automation.System Center Orchestrator Integration Modules includes converted versions of these integration packs that can be imported into Azure Automation and Service Management Automation.

Le versioni aggiornate degli Integration Pack basati su OIT che possono essere convertite con Integration Pack Converter verranno pubblicate tramite la versione RTM di questo strumento.By the RTM version of this tool, updated versions of the integration packs based on OIT that can be converted with the Integration Pack Converter will be published. Verranno anche offerte indicazioni per facilitare la conversione dei runbook mediante le attività degli Integration Pack non basati su OIT.Guidance will also be provided to assist you in converting runbooks using activities from the integration packs not based on OIT.

Runbook ConverterRunbook Converter

Runbook Converter converte i runbook di Orchestrator in runbook grafici che possono essere importati in Automazione di Azure.The Runbook Converter converts Orchestrator runbooks into graphical runbooks that can be imported into Azure Automation.

Runbook Converter è implementato come modulo PowerShell con un cmdlet denominato ConvertFrom-SCORunbook che esegue la conversione.Runbook Converter is implemented as a PowerShell module with a cmdlet called ConvertFrom-SCORunbook that performs the conversion. Quando si installa lo strumento, verrà creato un collegamento a una sessione di PowerShell che carica il cmdlet.When you install the tool, it will create a shortcut to a PowerShell session that loads the cmdlet.

Di seguito è illustrato il processo di base per convertire un runbook di Orchestrator e importarlo in Automazione di Azure.Following is the basic process to convert an Orchestrator runbook and import it into Azure Automation. Le sezioni seguenti offrono altre informazioni dettagliate sull'uso dello strumento con runbook convertiti.The following sections provide further details on using the tool and working with converted runbooks.

  1. Esportare uno o più runbook da Orchestrator.Export one or more runbooks from Orchestrator.
  2. Ottenere i moduli di integrazione per tutte le attività del runbook.Obtain integration modules for all activities in the runbook.
  3. Convertire i runbook di Orchestrator nel file esportato.Convert the Orchestrator runbooks in the exported file.
  4. Esaminare le informazioni nei log per convalidare la conversione e determinare eventuali attività manuali necessarie.Review information in logs to validate the conversion and to determine any required manual tasks.
  5. Importare i runbook convertiti in Automazione di Azure.Import converted runbooks into Azure Automation.
  6. Creare gli eventuali asset necessari in Automazione di Azure.Create any required assets in Azure Automation.
  7. Modificare il runbook in Automazione di Azure per modificare le attività necessarie.Edit the runbook in Azure Automation to modify any required activities.

Uso di Runbook ConverterUsing Runbook Converter

La sintassi per ConvertFrom-SCORunbook è la seguente:The syntax for ConvertFrom-SCORunbook is as follows:

ConvertFrom-SCORunbook -RunbookPath <string> -Module <string[]> -OutputFolder <string>
  • RunbookPath: percorso del file di esportazione contenente i runbook da convertire.RunbookPath - Path to the export file containing the runbooks to convert.
  • Module: elenco delimitato da virgole dei moduli di integrazione contenenti le attività nei runbook.Module - Comma delimited list of integration modules containing activities in the runbooks.
  • OutputFolder: percorso della cartella per creare runbook grafici convertiti.OutputFolder - Path to the folder to create converted graphical runbooks.

Il comando dell'esempio seguente converte i runbook in un file di esportazione denominato MyRunbooks.ois_export.The following example command converts the runbooks in an export file called MyRunbooks.ois_export. Questi runbook usano gli Integration Pack di Active Directory e di Data Protection Manager.These runbooks use the Active Directory and Data Protection Manager integration packs.

ConvertFrom-SCORunbook -RunbookPath "c:\runbooks\MyRunbooks.ois_export" -Module c:\ip\SystemCenter_IntegrationModule_ActiveDirectory.zip,c:\ip\SystemCenter_IntegrationModule_DPM.zip -OutputFolder "c:\runbooks"

File di logLog files

Runbook Converter crea i file di log seguenti nello stesso percorso del runbook convertito.The Runbook Converter will create the following log files in the same location as the converted runbook. Se i file esistono già, verranno sovrascritti con le informazioni dell'ultima conversione.If the files already exist, then they will be overwritten with information from the last conversion.

FileFile SommarioContents
Runbook Converter - Progress.logRunbook Converter - Progress.log Passaggi dettagliati della conversione, comprese le informazioni per ogni attività convertita correttamente e gli avvisi per ogni attività non convertita.Detailed steps of the conversion including information for each activity successfully converted and warning for each activity not converted.
Runbook Converter - Summary.logRunbook Converter - Summary.log Riepilogo dell'ultima conversione, compresi eventuali avvisi e attività di follow-up da eseguire, ad esempio la creazione di una variabile necessaria per il runbook convertito.Summary of the last conversion including any warnings and follow up tasks that you need to perform such as creating a variable required for the converted runbook.

Esportazione di runbook da OrchestratorExporting runbooks from Orchestrator

Runbook Converter funziona con un file di esportazione di Orchestrator che contiene uno o più runbook.The Runbook Converter works with an export file from Orchestrator that contains one or more runbooks. Crea un runbook di Automazione di Azure corrispondente per ogni runbook di Orchestrator nel file di esportazione.It will create a corresponding Azure Automation runbook for each Orchestrator runbook in the export file.

Per esportare un runbook da Orchestrator, fare clic con il pulsante destro del mouse sul nome del runbook in Runbook Designer e selezionare Esporta.To export a runbook from Orchestrator, right-click the name of the runbook in Runbook Designer and select Export. Per esportare tutti i runbook in una cartella, fare clic con il pulsante destro del mouse sul nome della cartella e selezionare Esporta.To export all runbooks in a folder, right-click the name of the folder and select Export.

Attività del RunbookRunbook activities

Runbook Converter converte ogni attività del runbook di Orchestrator in un'attività corrispondente in Automazione di Azure.The Runbook Converter converts each activity in the Orchestrator runbook to a corresponding activity in Azure Automation. Per le attività che non possono essere convertite, viene creata un'attività segnaposto nel runbook con un testo di avviso.For those activities that can't be converted, a placeholder activity is created in the runbook with warning text. Dopo aver importato il runbook convertito in Automazione di Azure, è necessario sostituire queste attività, se presenti, con attività valide che eseguono la funzionalità necessaria.After you import the converted runbook into Azure Automation, you must replace any of these activities with valid activities that perform the required functionality.

Le eventuali attività di Orchestrator nel modulo delle attività standard verranno convertite.Any Orchestrator activities in the Standard Activities Module will be converted. Tuttavia, vi sono alcune attività standard di Orchestrator che non sono in questo modulo e che non vengono convertite.There are some standard Orchestrator activities that are not in this module though and are not converted. Ad esempio, Invia evento piattaforma non ha un equivalente in Automazione di Azure, poiché l'evento è specifico di Orchestrator.For example, Send Platform Event has no Azure Automation equivalent since the event is specific to Orchestrator.

Attività di monitoraggio non vengono convertite, in quanto non hanno un equivalente in Automazione di Azure.Monitor activities are not converted since there is no equivalent to them in Azure Automation. L'eccezione sono le attività di monitoraggio negli Integration Pack convertiti , che verranno convertite in attività segnaposto.The exception are monitor activities in converted integration packs that will be converted to the placeholder activity.

Eventuali attività di un Integration Pack convertito verranno convertite se si specifica il percorso del modulo di integrazione con il parametro modules .Any activity from a converted integration pack will be converted if you provide the path to the integration module with the modules parameter. Per gli Integration Pack di System Center, è possibile usare i moduli di integrazione di System Center Orchestrator.For System Center Integration Packs, you can use the System Center Orchestrator Integration Modules.

Risorse di OrchestratorOrchestrator resources

Runbook Converter converte solo runbook, non altre risorse di Orchestrator, ad esempio contatori, variabili o connessioni.The Runbook Converter only converts runbooks, not other Orchestrator resources such as counters, variables, or connections. I contatori non sono supportati in Automazione di Azure.Counters are not supported in Azure Automation. Le variabili e le connessioni sono supportate, ma è necessario crearle manualmente.Variables and connections are supported, but you must create them manually. I file di log indicano se il runbook richiede tali risorse e specificano le risorse corrispondenti che è necessario creare in Automazione di Azure per il corretto funzionamento del runbook convertito.The log files will inform you if the runbook requires such resources and specify corresponding resources that you need to create in Azure Automation for the converted runbook to operate properly.

Ad esempio, un runbook potrebbe usare una variabile per popolare un determinato valore in un'attività.For example, a runbook may use a variable to populate a particular value in an activity. Il runbook convertito convertirà l'attività e specificherà un asset variabile in Automazione di Azure con lo stesso nome della variabile di Orchestrator.The converted runbook will convert the activity and specify a variable asset in Azure Automation with the same name as the Orchestrator variable. Questo verrà annotato nel file Runbook Converter - Summary.log creato dopo la conversione.This will be noted in the Runbook Converter - Summary.log file that is created after the conversion. È necessario creare manualmente questo asset variabile in Automazione di Azure prima di usare il runbook.You will need to manually create this variable asset in Azure Automation before using the runbook.

Parametri di inputInput parameters

I runbook di Orchestrator accettano parametri di input con l'attività Inizializza dati .Runbooks in Orchestrator accept input parameters with the Initialize Data activity. Se il runbook convertito include questa attività, viene creato un parametro di input nel runbook di Automazione di Azure per ogni parametro nell'attività.If the runbook being converted includes this activity, then an input parameter in the Azure Automation runbook is created for each parameter in the activity. Viene creata un'attività di controllo dello script del flusso di lavoro nel runbook convertito, che recupera e restituisce tutti i parametri.A Workflow Script control activity is created in the converted runbook that retrieves and returns each parameter. Eventuali attività del runbook che usano un parametro di input fanno riferimento all'output di questa attività.Any activities in the runbook that use an input parameter refer to the output from this activity.

Il motivo per cui viene usata questa strategia è riprodurre meglio la funzionalità nel runbook di Orchestrator.The reason that this strategy is used is to best mirror the functionality in the Orchestrator runbook. Le attività nei nuovi runbook grafici devono fare riferimento direttamente ai parametri di input usando un'origine dati di input del runbook.Activities in new graphical runbooks should refer directly to input parameters using a Runbook input data source.

Richiamare l'attività del runbookInvoke Runbook activity

I runbook di Orchestrator avviano altri runbook con l'attività Richiama Runbook .Runbooks in Orchestrator start other runbooks with the Invoke Runbook activity. Se il runbook convertito include questa attività e l'opzione Attendi completamento è impostata, viene creata un'attività del runbook per tale attività nel runbook convertito.If the runbook being converted includes this activity and the Wait for completion option is set, then a runbook activity is created for it in the converted runbook. Se l'opzione Attendi completamento non è impostata, viene creata un'attività dello script del flusso di lavoro che usa Start-AzureAutomationRunbook per avviare il runbook.If the Wait for completion option is not set, then a Workflow Script activity is created that uses Start-AzureAutomationRunbook to start the runbook. Dopo aver importato il runbook convertito in Automazione di Azure, è necessario modificare questa attività con le informazioni specificate nell'attività.After you import the converted runbook into Azure Automation, you must modify this activity with the information specified in the activity.