Creazione o importazione di un runbook in Automazione di AzureCreating or importing a runbook in Azure Automation

Per aggiungere un runbook ad Automazione di Azure, è possibile creare un nuovo runbook oppure importarne uno esistente da un file o dalla raccolta di runbook.You can add a runbook to Azure Automation by either creating a new one or by importing an existing runbook from a file or from the Runbook Gallery. In questo articolo vengono fornite informazioni sulla creazione e importazione di runbook da un file.This article provides information on creating and importing runbooks from a file. È possibile ottenere tutti i dettagli sull'accesso ai runbook e ai moduli della community in Raccolte di runbook e moduli per l'automazione di Azure.You can get all of the details on accessing community runbooks and modules in Runbook and module galleries for Azure Automation.

Creazione di un nuovo runbookCreating a new runbook

È possibile creare un nuovo runbook in Automazione di Azure usando uno dei portali di Azure o Windows PowerShell.You can create a new runbook in Azure Automation using one of the Azure portals or Windows PowerShell. Dopo aver creato il runbook, è possibile modificarlo usando le informazioni contenute in Informazioni sul flusso di lavoro di PowerShell e Creazione grafica in Automazione di Azure.Once the runbook has been created, you can edit it using information in Learning PowerShell Workflow and Graphical authoring in Azure Automation.

Per creare un nuovo runbook di Automazione di Azure nel portale di Azure classicoTo create a new Azure Automation runbook with the Azure classic portal

Nel portale di Azure è possibile usare solo i runbook del flusso di lavoro PowerShell .You can only work with PowerShell Workflow runbooks in the Azure portal.

  1. Nel portale di Azure classico fare clic su Nuovo, Servizi app, Automazione, Runbook e quindi Creazione rapida.In the Azure classic portal, click, New, App Services, Automation, Runbook, Quick Create.
  2. Immettere le informazioni necessarie e quindi fare clic su Crea.Enter the required information, and then click Create. Il nome del runbook deve iniziare con una lettera e può includere lettere, numeri, caratteri di sottolineatura e trattini.The runbook name must start with a letter and can have letters, numbers, underscores, and dashes.
  3. Se si desidera modificare il runbook ora, fare clic su Modifica runbook.If you want to edit the runbook now, then click Edit Runbook. In caso contrario, fare clic su OK.Otherwise, click OK.
  4. Il nuovo runbook viene visualizzato nella scheda Runbook .Your new runbook appears on the Runbooks tab.

Per creare un nuovo runbook di Automazione di Azure nel portale di AzureTo create a new Azure Automation runbook with the Azure portal

  1. Nel portale di Azure aprire l'account di automazione.In the Azure portal, open your Automation account.
  2. Dall'hub selezionare Runbook per aprire l'elenco dei runbook.From the Hub, select Runbooks to open the list of runbooks.
  3. Fare clic sul pulsante Aggiungi runbook e quindi su Crea un nuovo runbook.Click on the Add a runbook button and then Create a new runbook.
  4. Digitare un nome per il runbook e selezionare il relativo tipo.Type a Name for the runbook and select its Type. Il nome del runbook deve iniziare con una lettera e può includere lettere, numeri, caratteri di sottolineatura e trattini.The runbook name must start with a letter and can have letters, numbers, underscores, and dashes.
  5. Fare clic su Crea per creare il runbook e aprire l'editor.Click Create to create the runbook and open the editor.

Per creare un nuovo runbook di Automazione di Azure con Windows PowerShellTo create a new Azure Automation runbook with Windows PowerShell

È possibile usare il cmdlet New-AzureRmAutomationRunbook per creare un runbook del flusso di lavoro PowerShell vuoto.You can use the New-AzureRmAutomationRunbook cmdlet to create an empty PowerShell Workflow runbook. È possibile specificare il parametro Name per creare un runbook vuoto modificabile successivamente oppure il parametro Path per importare un file di runbook.You can either specify the Name parameter to create an empty runbook that you can later edit, or you can specify the Path parameter to import a runbook file. Anche il parametro Type deve essere incluso per specificare uno dei quattro tipi di runbook.The Type parameter should also be included to specify one of the four runbook types.

I comandi di esempio seguenti mostrano come creare un nuovo runbook vuoto.The following sample commands show how to create a new empty runbook.

New-AzureRmAutomationRunbook -AutomationAccountName MyAccount `
-Name NewRunbook -ResourceGroupName MyResourceGroup -Type PowerShell

Importazione di un runbook da un file in Automazione di AzureImporting a runbook from a file into Azure Automation

È possibile creare un nuovo runbook in Automazione di Azure mediante l'importazione di uno script di PowerShell o un flusso di lavoro PowerShell (con estensione ps1), un runbook grafico esportato (con estensione graphrunbook), o uno script Python 2 (con estensione py).You can create a new runbook in Azure Automation by importing a PowerShell script or PowerShell Workflow (.ps1 extension), an exported graphical runbook (.graphrunbook), or a Python 2 script (.py extension). È necessario specificare il tipo di runbook che viene creato durante l'importazione tenendo conto delle considerazioni seguenti.You must specify the type of runbook that is created during import, taking into account the following considerations.

  • Un file con estensione GRAPHRUNBOOK può essere importato solo in un nuovo runbook grafico, mentre i runbook grafici possono essere creati solo da un file con estensione GRAPHRUNBOOK.A .graphrunbook file may only be imported into a new graphical runbook, and graphical runbooks can only be created from a .graphrunbook file.
  • Un file con estensione PS1 che contiene un flusso di lavoro di PowerShell può essere importato solo in un runbook del flusso di lavoro PowerShell.A .ps1 file containing a PowerShell Workflow can only be imported into a PowerShell Workflow runbook. Se il file contiene più flussi di lavoro PowerShell, l'importazione avrà esito negativo.If the file contains multiple PowerShell Workflows, then the import will fail. È necessario salvare ogni flusso di lavoro nel relativo file e importare ogni file separatamente.You must save each workflow to its own file and import each separately.
  • Un file con estensione ps1 che non contiene un flusso di lavoro può essere importato in un runbook di PowerShell o in un runbook del flusso di lavoro PowerShell.A .ps1 file that does not contain a workflow can be imported into either a PowerShell runbook or a PowerShell Workflow runbook. Se viene importato in un runbook del flusso di lavoro PowerShell, il file viene quindi convertito in un flusso di lavoro, dove sono inclusi i commenti contenenti le modifiche apportate.If it is imported into a PowerShell Workflow runbook, then it is converted to a workflow, and comments are included in the runbook specifying the changes that were made.

Per importare un runbook da un file con il portale di Azure classicoTo import a runbook from a file with the Azure classic portal

È possibile usare la procedura seguente per importare un file di script in Automazione di Azure.You can use the following procedure to import a script file into Azure Automation. Si noti che è possibile importare solo un file con estensione PS1 in un runbook del flusso di lavoro PowerShell con questo portale.Note that you can only import a .ps1 file into a PowerShell Workflow runbook using this portal. È necessario usare il portale di Azure per gli altri tipi.You must use the Azure portal for other types.

  1. Nel portale di Azure classico selezionare Automazione e selezionare un account di automazione.In the Azure classic portal, select Automation and then select an Automation Account.
  2. Fare clic su Importa.Click Import.
  3. Fare clic su Cerca file e individuare il file di script da importare.Click Browse for File and locate the script file to import.
  4. Se si desidera modificare il runbook ora, fare clic su Modifica runbook.If you want to edit the runbook now, then click Edit Runbook. In caso contrario, fare clic su OK.Otherwise, click OK.
  5. Il nuovo runbook viene visualizzato nella scheda Runbook per l'account di automazione.The new runbook appears on the Runbooks tab for the Automation Account.
  6. È necessario pubblicare il runbook prima di poterlo eseguire.You must publish the runbook before you can run it.

Per importare un runbook da un file con il portale di AzureTo import a runbook from a file with the Azure portal

È possibile usare la procedura seguente per importare un file di script in Automazione di Azure.You can use the following procedure to import a script file into Azure Automation.

Nota

Si noti che è possibile importare solo un file con estensione PS1 in un runbook del flusso di lavoro PowerShell con il portale.Note that you can only import a .ps1 file into a PowerShell Workflow runbook using the portal.

  1. Nel portale di Azure aprire l'account di automazione.In the Azure portal, open your Automation account.
  2. Dall'hub selezionare Runbook per aprire l'elenco dei runbook.From the Hub, select Runbooks to open the list of runbooks.
  3. Fare clic sul pulsante Aggiungi runbook e quindi su Importa.Click on the Add a runbook button and then Import.
  4. Fare clic su File di runbook per selezionare il file da importare.Click Runbook file to select the file to import
  5. Se il campo Nome è abilitato, sarà possibile modificare il nome.If the Name field is enabled, then you have the option to change it. Il nome del runbook deve iniziare con una lettera e può includere lettere, numeri, caratteri di sottolineatura e trattini.The runbook name must start with a letter and can have letters, numbers, underscores, and dashes.
  6. Il tipo di runbook viene selezionato automaticamente, ma è possibile modificarlo dopo aver valutato le restrizioni applicabili.The runbook type is automatically selected, but you can change the type after taking the applicable restrictions into account.
  7. Il nuovo runbook verrà visualizzato nell'elenco dei runbook dell'account di automazione.The new runbook appears in the list of runbooks for the Automation Account.
  8. È necessario pubblicare il runbook prima di poterlo eseguire.You must publish the runbook before you can run it.

Nota

Dopo aver importato un runbook grafico o un runbook grafico del flusso di lavoro PowerShell, è possibile convertirlo in un altro tipo, se necessario.After you import a graphical runbook or a graphical PowerShell workflow runbook, you have the option to convert to the other type if wanted. Non è possibile eseguire la conversione verso un runbook in formato di testo.You can’t convert to a textual runbook.

Per importare un runbook da un file di script con Windows PowerShellTo import a runbook from a script file with Windows PowerShell

È possibile usare il cmdlet Import-AzureRMAutomationRunbook per importare un file di script come bozza di un runbook del flusso di lavoro PowerShell.You can use the Import-AzureRMAutomationRunbook cmdlet to import a script file as a draft PowerShell Workflow runbook. Se il runbook esiste già, l'importazione non riesce, a meno che non si usi il parametro -Force .If the runbook already exists, the import fails unless you use the -Force parameter.

I comandi di esempio seguenti mostrano come importare un file di script in un runbook.The following sample commands show how to import a script file into a runbook.

$automationAccountName =  "AutomationAccount"
$runbookName = "Sample_TestRunbook"
$scriptPath = "C:\Runbooks\Sample_TestRunbook.ps1"
$RGName = "ResourceGroup"

Import-AzureRMAutomationRunbook -Name $runbookName -Path $scriptPath `
-ResourceGroupName $RGName -AutomationAccountName $automationAccountName `
-Type PowerShellWorkflow 

Pubblicazione di un runbookPublishing a runbook

Quando si crea o si importa un nuovo runbook, è necessario pubblicarlo prima di poterlo eseguire.When you create or import a new runbook, you must publish it before you can run it. Ogni runbook in Automazione include una versione bozza e una versione pubblicata.Each runbook in Automation has a Draft and a Published version. È possibile eseguire solo la versione pubblicata, mentre è possibile modificare solo la versione bozza.Only the Published version is available to be run, and only the Draft version can be edited. La versione pubblicata non è interessata dalle modifiche apportate alla versione bozza.The Published version is unaffected by any changes to the Draft version. Dopo aver reso disponibile la versione bozza, è possibile pubblicarla sovrascrivendo così la versione pubblicata.When the Draft version should be made available, then you publish it which overwrites the Published version with the Draft version.

Per pubblicare un runbook usando il portale di Azure classicoTo publish a runbook using the Azure classic portal

  1. Aprire il runbook nel portale di Azure classico.Open the runbook in the Azure classic portal.
  2. Nella parte superiore della schermata fare clic su Creazione.At the top of the screen, click Author.
  3. Nella parte inferiore della schermata fare clic su Pubblica e quindi nel messaggio di verifica.At the bottom of the screen, click Publish and then Yes to the verification message.

Per pubblicare un runbook usando il portale di AzureTo publish a runbook using the Azure portal

  1. Aprire il runbook nel portale di Azure.Open the runbook in the Azure portal.
  2. Fare clic sul pulsante Modifica .Click the Edit button.
  3. Fare clic sul pulsante Pubblica e quindi su nel messaggio di verifica.Click the Publish button and then Yes to the verification message.

Per pubblicare un runbook usando Windows PowerShellTo publish a runbook using Windows PowerShell

È possibile usare il cmdlet Publish-AzureRmAutomationRunbook per pubblicare un runbook con Windows PowerShell.You can use the Publish-AzureRmAutomationRunbook cmdlet to publish a runbook with Windows PowerShell. I comandi di esempio seguenti mostrano come pubblicare un runbook di esempio.The following sample commands show how to publish a sample runbook.

$automationAccountName =  AutomationAccount"
$runbookName = "Sample_TestRunbook"
$RGName = "ResourceGroup"

Publish-AzureRmAutomationRunbook -AutomationAccountName $automationAccountName `
-Name $runbookName -ResourceGroupName $RGName

Passaggi successiviNext Steps