Impostazioni dei runbookRunbook settings

Ogni runbook in Automazione di Azure dispone di più impostazioni che consentono di identificarlo e di modificarne il comportamento di registrazione.Each runbook in Azure Automation has multiple settings that help it to be identified and to change its logging behavior. Per ognuna di queste impostazioni, di seguito viene riportata una descrizione e vengono illustrate le procedure di modifica.Each of these settings is described below followed by procedures on how to modify them.

ImpostazioniSettings

Nome e descrizioneName and description

Non è possibile modificare il nome di un runbook dopo che è stato creato.You cannot change the name of a runbook after it has been created. La descrizione è facoltativa e può contenere fino a 512 caratteri.The Description is optional and can be up to 512 characters.

TagTags

I tag consentono di assegnare parole e frasi distinte per facilitare l'identificazione di un runbook.Tags allow you to assign distinct words and phrases to help identify a runbook. Quando si invia un runbook alla PowerShell Gallery, è possibile ad esempio specificare tag particolari per identificare le categorie in cui il runbook deve essere elencato.For example, when you submit a runbook to the PowerShell Gallery, you specify particular tags to identify which categories the runbook should be listed in. È possibile specificare più tag per un runbook separandole con le virgole.You can specify multiple tags for a runbook by separating them with commas.

RegistrazioneLogging

Per impostazione predefinita, i record dettagliati e di avanzamento non vengono scritti nella cronologia processo.By default, Verbose and Progress records are not written to job history. È possibile modificare le impostazioni per un determinato runbook per registrare questi record.You can change the settings for a particular runbook to log these records. Per altre informazioni su tali record, vedere Messaggi e output del runbook.For more information on these records, see Runbook Output and Messages.

Modifica delle impostazioni dei runbookChanging runbook settings

Modifica delle impostazioni dei runbook nel portale di AzureChanging runbook settings with the Azure portal

Per modificare le impostazioni di un runbook nel portale di Azure, usare il pannello Impostazioni corrispondente.You can change settings for a runbook in the Azure portal from the Settings blade for the runbook.

  1. Nel portale di Azure selezionare Automazione e quindi fare clic sul nome di un account di automazione.In the Azure portal, select Automation and then then click the name of an automation account.
  2. Fare clic sulla scheda Runbook .Select the Runbooks tab.
  3. Fare clic sul nome di un runbook per aprire il pannello delle impostazioni corrispondente.Click the name of a runbook and you are directed to the settings blade for the runbook. In tale pannello è possibile specificare o modificare i tag e la descrizione del runbook, configurare le impostazioni di traccia e registrazione e accedere agli strumenti di supporto per la risoluzione dei problemi.From here you can specify or modify tags, the runbook description, configure logging and tracing settings, and access support tools to help you solve problems.

Modifica delle impostazioni dei runbook con Windows PowerShellChanging runbook settings with Windows PowerShell

Per modificare le impostazioni di un runbook, è possibile usare il cmdlet Set-AzureRmAutomationRunbook.You can use the Set-AzureRmAutomationRunbook cmdlet to change the settings for a runbook. Se si intende specificare più tag, è possibile fornire una matrice o una singola stringa con valori delimitati da virgole per il parametro Tags.If you want to specify multiple tags, you can either provide an array or a single string with comma delimited values to the Tags parameter. Per ottenere i tag correnti, usare Get-AzureRmAutomationRunbook.You can get the current tags with the Get-AzureRmAutomationRunbook.

I comandi di esempio seguenti illustrano come impostare le proprietà di un runbook.The following sample commands show how to set the properties for a runbook. Questo esempio aggiunge tre tag ai tag esistenti e specifica che vengano registrati i record dettagliati.This sample adds three tags to the existing tags and specifies that verbose records should be logged.

$automationAccountName = "MyAutomationAccount"
$runbookName = "Sample-TestRunbook"
$tags = (Get-AzureRmAutomationRunbook -ResourceGroupName "ResourceGroup01" `
–AutomationAccountName $automationAccountName –Name $runbookName).Tags
$tags += "Tag1,Tag2,Tag3"
Set-AzureRmAutomationRunbook -ResourceGroupName "ResourceGroup01" `
–AutomationAccountName $automationAccountName –Name $runbookName –LogVerbose $true –Tags $tags

Passaggi successiviNext steps