Modifica di runbook testuali in Automazione di AzureEditing textual runbooks in Azure Automation

L'editor di testo in Automazione di Azure può essere usato per modificare i runbook di PowerShell e i runbook del flusso di lavoro PowerShell.The textual editor in Azure Automation can be used to edit PowerShell runbooks and PowerShell Workflow runbooks. Questo editor dispone delle funzionalità tipiche degli altri editor di codice, ad esempio IntelliSense e la codifica a colori con particolari funzionalità aggiuntive per semplificare l'accesso alle risorse comuni dei runbook.This has the typical features of other code editors such as intellisense and color coding with additional special features to assist you in accessing resources common to runbooks. In questo articolo vengono fornite procedure dettagliate per l'esecuzione delle diverse funzioni disponibili in questo editor.This article provides detailed steps for performing different functions with this editor.

L'editor di testo include una funzionalità per inserire codice per cmdlet, risorse e runbook figlio all'interno di un runbook.The textual editor includes a feature to insert code for cmdlets, assets, and child runbooks into a runbook. Invece di digitare il codice manualmente, è possibile effettuare selezioni in un elenco di risorse disponibili e inserire automaticamente il codice nel runbook.Rather than typing in the code yourself, you can select from a list of available resources and have the appropriate code inserted into the runbook.

Ogni runbook in Automazione di Azure include due versioni, ovvero una versione bozza e una versione pubblicata.Each runbook in Azure Automation has two versions, Draft and Published. Si modifica la versione bozza del runbook e quindi lo si pubblica in modo da poterlo eseguire.You edit the Draft version of the runbook and then publish it so it can be executed. La versione pubblicata non può essere modificata.The Published version cannot be edited. Per altre informazioni, vedere Pubblicazione di un runbook .See Publishing a runbook for more information.

Per usare i runbook grafici, vedere Creazione grafica in Automazione di Azure.To work with Graphical Runbooks, see Graphical authoring in Azure Automation.

Per modificare un runbook con il portale di AzureTo edit a runbook with the Azure portal

Usare la procedura seguente per aprire un runbook per la modifica nell'editor di testo.Use the following procedure to open a runbook for editing in the textual editor.

  1. Nel portale di Azure selezionare l'account di automazione.In the Azure portal, select your automation account.
  2. In AUTOMAZIONE PROCESSI selezionare Runbook per aprire l'elenco dei runbook.Under PROCESS AUTOMATION, select Runbooks to open the list of runbooks.
  3. Selezionare il runbook che si vuole modificare e quindi fare clic sul pulsante Modifica.Select the runbook you want to edit and then click the Edit button.
  4. Apportare le modifiche necessarie.Perform the required editing.
  5. Fare clic su Salva dopo aver completato le modifiche desiderate.Click Save when your edits are complete.
  6. Fare clic su Pubblica se si desidera pubblicare la versione bozza più recente del runbook.Click Publish if you want the latest draft version of the runbook to be published.

Per inserire un cmdlet in un runbookTo insert a cmdlet into a runbook

  1. Nel canvas dell'editor di testo posizionare il cursore nel punto in cui si desidera inserire il cmdlet.In the Canvas of the textual editor, position the cursor where you want to place the cmdlet.
  2. Espandere il nodo Cmdlet nel controllo della libreria.Expand the Cmdlets node in the Library control.
  3. Espandere il modulo contenente il cmdlet che si desidera usare.Expand the module containing the cmdlet you want to use.
  4. Fare clic con il pulsante destro sul cmdlet da inserire e selezionare Aggiungi a canvas.Right click the cmdlet to insert and select Add to canvas. Se il cmdlet include più di un set di parametri, verrà aggiunto il set predefinito.If the cmdlet has more than one parameter set, then the default set will be added. È inoltre possibile espandere il cmdlet per selezionare un set di parametri diverso.You can also expand the cmdlet to select a different parameter set.
  5. Il codice per il cmdlet viene inserito con l'intero elenco di parametri.The code for the cmdlet is inserted with its entire list of parameters.
  6. Fornire un valore appropriato al posto del tipo di dati racchiuso tra parentesi graffe <> per gli eventuali parametri obbligatori.Provide an appropriate value in place of the data type surrounded by braces <> for any required parameters. Rimuovere i parametri non necessari.Remove any parameters you don't need.

Per inserire il codice per un runbook figlio all'interno di un runbookTo insert code for a child runbook into a runbook

  1. Nel canvas dell'editor di testo posizionare il cursore nel punto in cui si desidera inserire il codice per il runbook figlio.In the Canvas of the textual editor, position the cursor where you want to place the code for the child runbook.
  2. Espandere il nodo Runbook nel controllo della libreria.Expand the Runbooks node in the Library control.
  3. Fare clic con il pulsante destro sul runbook da inserire e selezionare Aggiungi a canvas.Right click the runbook to insert and select Add to canvas.
  4. Il codice relativo al runbook figlio viene inserito con qualsiasi segnaposto necessario per i parametri del runbook.The code for the child runbook is inserted with any placeholders for any runbook parameters.
  5. Sostituire i segnaposto con i valori appropriati per ogni parametro.Replace the placeholders with appropriate values for each parameter.

Per inserire un asset in un runbookTo insert an asset into a runbook

  1. Nel canvas dell'editor di testo posizionare il cursore nel punto in cui si desidera inserire il codice per il runbook figlio.In the Canvas of the textual editor, position the cursor where you want to place the code for the child runbook.
  2. Espandere il nodo Asset nel controllo della libreria.Expand the Assets node in the Library control.
  3. Espandere il nodo per il tipo di asset desiderato.Expand the node for the type of asset you want.
  4. Fare clic con il pulsante destro sull'asset da inserire e selezionare Aggiungi a canvas.Right click the asset to insert and select Add to canvas. Per gli asset di tipo variabile, selezionare l'opzione Aggiungi "Ottieni variabile" a canvas o Aggiungi "Imposta variabile" a canvas a seconda che si desideri ottenere o impostare la variabile.For variable assets, select either Add "Get Variable" to canvas or Add "Set Variable" to canvas depending on whether you want to get or set the variable.
  5. Il codice per l'asset viene inserito nel runbook.The code for the asset is inserted into the runbook.

Per modificare un runbook di Automazione di Azure tramite Windows PowerShellTo edit an Azure Automation runbook using Windows PowerShell

Per modificare un runbook con Windows PowerShell, usare l'editor desiderato e salvarlo in un file con estensione PS1.To edit a runbook with Windows PowerShell, you use the editor of your choice and save it to a .ps1 file. È possibile usare il cmdlet Get-AzureAutomationRunbookDefinition per recuperare il contenuto del runbook e quindi il cmdlet Set-AzureAutomationRunbookDefinition per sostituire la versione bozza del runbook esistente con quello modificato.You can use the Get-AzureAutomationRunbookDefinition cmdlet to retrieve the contents of the runbook and then Set-AzureAutomationRunbookDefinition cmdlet to replace the existing draft runbook with the modified one.

Per recuperare il contenuto di un runbook con Windows PowerShellTo Retrieve the Contents of a Runbook Using Windows PowerShell

I comandi di esempio seguenti mostrano come recuperare lo script per un runbook e salvarlo in un file di script.The following sample commands show how to retrieve the script for a runbook and save it to a script file. In questo esempio viene recuperata la versione bozza.In this example, the Draft version is retrieved. È inoltre possibile recuperare la versione pubblicata del runbook, sebbene questa versione non possa essere modificata.It is also possible to retrieve the Published version of the runbook although this version cannot be changed.

$automationAccountName = "MyAutomationAccount"
$runbookName = "Sample-TestRunbook"
$scriptPath = "c:\runbooks\Sample-TestRunbook.ps1"

$runbookDefinition = Get-AzureAutomationRunbookDefinition -AutomationAccountName $automationAccountName -Name $runbookName -Slot Draft
$runbookContent = $runbookDefinition.Content

Out-File -InputObject $runbookContent -FilePath $scriptPath

Per modificare il contenuto di un Runbook con Windows PowerShellTo Change the Contents of a Runbook Using Windows PowerShell

I comandi di esempio seguenti mostrano come sostituire il contenuto di un runbook con il contenuto di un file di script.The following sample commands show how to replace the existing contents of a runbook with the contents of a script file. Si noti che questa è la stessa procedura di esempio descritta in Per importare un runbook da un file di script con Windows PowerShell.Note that this is the same sample procedure as in To import a runbook from a script file with Windows PowerShell.

$automationAccountName = "MyAutomationAccount"
$runbookName = "Sample-TestRunbook"
$scriptPath = "c:\runbooks\Sample-TestRunbook.ps1"

Set-AzureAutomationRunbookDefinition -AutomationAccountName $automationAccountName -Name $runbookName -Path $scriptPath -Overwrite
Publish-AzureAutomationRunbook –AutomationAccountName $automationAccountName –Name $runbookName