Raccolte di runbook e moduli per l'automazione di AzureRunbook and module galleries for Azure Automation

Anziché creare runbook e moduli personalizzati in Automazione di Azure, si può ricorrere a una serie di scenari già creati da Microsoft e dalla community.Rather than creating your own runbooks and modules in Azure Automation, you can access a variety of scenarios that have already been built by Microsoft and the community. Questi scenari possono essere usati senza alcuna modifica oppure possono essere utilizzati come punto di partenza apportando tutte le modifiche necessarie in base alle specifiche esigenze.You can either use these scenarios without modification or you can use them as a starting point and edit them for your specific requirements.

È possibile trovare runbook nella raccolta di runbook e moduli in PowerShell Gallery.You can get runbooks from the Runbook Gallery and modules from the PowerShell Gallery. Si può anche contribuire alla community condividendo gli scenari sviluppati personalmente.You can also contribute to the community by sharing scenarios that you develop.

La raccolta di runbook offre un'ampia gamma di runbook di Microsoft e della community che è possibile importare in Automazione di Azure.The Runbook Gallery provides a variety of runbooks from Microsoft and the community that you can import into Azure Automation. È possibile scaricare un runbook dalla raccolta disponibile nello Script Center di TechNet oppure importare runbook direttamente dalla raccolta dal portale di Azure classico o dal portale di Azure.You can either download a runbook from the gallery, which is hosted in the TechNet Script Center, or you can directly import runbooks from the gallery from either the Azure classic portal or Azure portal.

È possibile importare solo direttamente dalla raccolta di runbook usando il portale di Azure classico o il portale di Azure.You can only import directly from the Runbook Gallery using the Azure classic portal or Azure portal. Non è possibile eseguire questa funzione tramite Windows PowerShell.You cannot perform this function using Windows PowerShell.

Nota

È necessario convalidare il contenuto di qualsiasi runbook ottenuto dalla raccolta di runbook e prestare particolare attenzione durante la loro installazione ed esecuzione in un ambiente di produzione. |You should validate the contents of any runbooks that you get from the Runbook Gallery and use extreme caution in installing and running them in a production environment.|

  1. Nel portale di Azure fare clic su Nuovo, Servizi app, Automazione, Runbook, Da raccolta.In the Azure portal, click, New, App Services, Automation, Runbook, From Gallery.
  2. Selezionare una categoria per visualizzare i runbook correlati e quindi selezionare un runbook per visualizzarne i dettagli.Select a category to view related runbooks, and select a runbook to view its details. Dopo aver selezionato il runbook desiderato, fare clic sul pulsante con la freccia destra.When you select the runbook you want, click the right arrow button.

    raccolta di runbook

  3. Esaminare il contenuto del runbook e prendere nota di eventuali requisiti nella descrizione.Review the contents of the runbook and note any requirements in the description. Al termine, fare clic sul pulsante con la freccia destra.Click the right arrow button when you’re done.
  4. Immettere i dettagli del runbook e quindi fare clic sul pulsante con il segno di spunta.Enter the runbook details and then click the checkmark button. Il nome di runbook è già specificato.The runbook name is already filled in.
  5. Il runbook viene visualizzato nella scheda Runbook per l'account di automazione.The runbook appears on the Runbooks tab for the Automation Account.
  1. Nel portale di Azure aprire l'account di automazione.In the Azure portal, open your Automation account.
  2. Fare clic sul riquadro Runbook per aprire l'elenco dei runbook.Click on the Runbooks tile to open the list of runbooks.
  3. Fare clic sul pulsante Sfoglia raccolta .Click Browse gallery button.

    Pulsante Sfoglia raccolta

  4. Individuare l'elemento della raccolta desiderato e selezionarlo per visualizzarne i dettagli.Locate the gallery item you want and select it to view its details.

    Sfoglia raccolta

  5. Fare clic su Visualizza progetto di origine per visualizzare l'elemento nello Script Center di TechNet.Click on View source project to view the item in the TechNet Script Center.
  6. Per importare un elemento, fare clic su di esso per visualizzarne i dettagli e quindi scegliere il pulsante Importa .To import an item, click on it to view its details and then click the Import button.

    Pulsante Importa

  7. Facoltativamente, modificare il nome del runbook e quindi fare clic su OK per importare il runbook.Optionally, change the name of the runbook and then click OK to import the runbook.
  8. Il runbook viene visualizzato nella scheda Runbook per l'account di automazione.The runbook appears on the Runbooks tab for the Automation Account.

Microsoft consiglia di aggiungere alla raccolta dei runbook i runbook ritenuti più utili per gli altri clienti.Microsoft encourages you to add runbooks to the Runbook Gallery that you think would be useful to other customers. È possibile aggiungere un runbook caricandolo nello Script Center , a condizione che si considerino i seguenti dettagli.You can add a runbook by uploading it to the Script Center taking into account the following details.

  • Per il runbook da visualizzare nella procedura guidata, è necessario specificare Windows Azure nel campo Categoria e Automazione nel campo Sottocategoria.You must specify Windows Azure for the Category and Automation for the Subcategory for the runbook to be displayed in the wizard.
  • Il caricamento deve interessare un singolo file con estensione PS1 o GRAPHRUNBOOK.The upload must be a single .ps1 or .graphrunbook file. Se il runbook richiede eventuali moduli, runbook figlio o asset, è consigliabile elencare questi elementi nella descrizione dell'invio e nella sezione dei commenti del runbook.If the runbook requires any modules, child runbooks, or assets, then you should list those in the description of the submission and in the comments section of the runbook. Se si dispone di uno scenario che richiede più runbook, caricare ciascuna soluzione separatamente ed elencare i nomi dei runbook correlati in ognuna delle relative descrizioni.If you have a scenario requiring multiple runbooks, then upload each separately and list the names of the related runbooks in each of their descriptions. Assicurarsi di usare gli stessi tag in modo che vengano visualizzati nella stessa categoria.Make sure that you use the same tags so that they show up in the same category. L'utente dovrà fare riferimento alla descrizione per sapere se sono necessari altri runbook per il corretto funzionamento dello scenario.A user will have to read the description to know that other runbooks are required the scenario to work.
  • Se si pubblica un runbook grafico (non un flusso di lavoro grafico), aggiungere il tag "GraficoPS".Add the tag "GraphicalPS" if you are publishing a Graphical runbook (not a Graphical Workflow).
  • Inserire un frammento di codice di PowerShell o di un flusso di lavoro PowerShell nella descrizione mediante l’icona Inserisci sezione di codice .Insert either a PowerShell or PowerShell Workflow code snippet into the description using Insert code section icon.
  • Nei risultati della raccolta di runbook viene visualizzato il riepilogo del caricamento. Sarà pertanto necessario fornire informazioni dettagliate che consentano a un utente di identificare le funzionalità del runbook.The Summary for the upload is displayed in the Runbook Gallery results so you should provide detailed information that helps a user identify the functionality of the runbook.
  • È consigliabile assegnare da uno a tre dei seguenti tag al caricamento.You should assign one to three of the following Tags to the upload. Il runbook viene elencato nella procedura guidata nelle categorie corrispondenti ai relativi tag.The runbook is listed in the wizard under the categories that match its tags. Qualsiasi tag non incluso nell'elenco viene ignorato dalla procedura guidata.Any tags not on this list are ignored by the wizard. Se non si specifica alcun tag corrispondente, il runbook viene elencato nella categoria Altro.If you don’t specify any matching tags, the runbook is listed under the Other category.

    • BackupBackup
    • Capacity ManagementCapacity Management
    • Controllo modificheChange Control
    • ConformitàCompliance
    • Ambiente di testing/sviluppoDev / Test Environments
    • Ripristino di emergenzaDisaster Recovery
    • MonitoraggioMonitoring
    • Applicazione di patchPatching
    • ProvisioningProvisioning
    • CorrezioneRemediation
    • Gestione del ciclo di vita VMVM Lifecycle Management
  • L'automazione aggiorna la raccolta una volta all'ora. Pertanto i contributi non verranno visualizzati immediatamente.Automation updates the Gallery once an hour, so you won’t see your contributions immediately.

I moduli di PowerShell contengono cmdlet che è possibile usare all'interno dei runbook, mentre in PowerShell Gallerysono disponibili moduli esistenti che è possibile installare in Automazione di Azure.PowerShell modules contain cmdlets that you can use in your runbooks, and existing modules that you can install in Azure Automation are available in the PowerShell Gallery. È possibile avviare questa raccolta dal portale di Azure e installarli direttamente in Automazione di Azure oppure è possibile scaricarli e installarli manualmente.You can launch this gallery from the Azure portal and install them directly into Azure Automation or you can download them and install them manually. Non è possibile installare i moduli direttamente dal portale di Azure classico, ma è possibile scaricarli e installarli come qualsiasi altro modulo.You cannot install the modules directly from the Azure classic portal, but you can download them install them as you would any other module.

  1. Nel portale di Azure aprire l'account di automazione.In the Azure portal, open your Automation account.
  2. Selezionare Moduli in Risorse condivise per aprire l'elenco di moduli.Select Modules under Shared Resources to open the list of modules.
  3. Fare clic su Esplora raccolta nella parte superiore della pagina.Click Browse gallery from the top of the page.

    Raccolta di moduli

  4. Nella pagina Esplora raccolta è possibile eseguire la ricerca in base ai campi seguenti:On the Browse gallery page, you can search by the following fields:

    • Nome moduloModule Name
    • TagTags
    • AutoreAuthor
    • Nome della risorsa cmdlet/DSCCmdlet/DSC resource name
  5. Cercare il modulo desiderato e selezionarlo per visualizzarne i dettagli.Locate a module that you're interested in and select it to view its details.
    Quando si analizza un modulo specifico, è possibile visualizzare altre informazioni sul modulo, inclusi un collegamento a PowerShell Gallery, eventuali dipendenze necessarie e tutte le risorse cmdlet/DSC contenute nel modulo.When you drill into a specific module, you can view more information about the module, including a link back to the PowerShell Gallery, any required dependencies, and all of the cmdlets and/or DSC resources that the module contains.

    Informazioni sul modulo di PowerShell

  6. Per installare il modulo direttamente in Automazione di Azure, fare clic sul pulsante Importa .To install the module directly into Azure Automation, click the Import button.

    Pulsante Importa modulo

  7. Quando si fa clic sul pulsante Importa, nel riquadro Importa viene visualizzato il nome del modulo che verrà importato.When you click the Import button, on the Import pane, you see the module name that you are about to import. Se tutte le dipendenze sono installate, il pulsante OK è attivo.If all the dependencies are installed, the OK button is activated. Se non sono presenti tutte le dipendenze richieste, è necessario importarle prima di importare il modulo.If you are missing dependencies, you need to import those before you can import this module.
  8. Fare clic su OK per importare il modulo.Click OK to import the module. Durante l'importazione del modulo nell'account, Automazione di Azure estrae i metadati sul modulo e i cmdlet.While Azure Automation imports a module to your account, it extracts metadata about the module and the cmdlets.

    Pagina di importazione del modulo

    Poiché ogni attività deve essere estratta potrebbero volerci alcuni minuti.This may take a couple of minutes since each activity needs to be extracted.

  9. Si riceverà una notifica iniziale per indicare che è in corso la distribuzione del modulo e un'altra notifica al termine dell'operazione.You receive an initial notification that the module is being deployed and another notification when it has completed.
  10. Dopo aver importato il modulo, è possibile visualizzare le attività disponibili e usare le risorse nei runbook e in Desired State Configuration.After the module is imported, you can see the available activities, and you can use its resources in your runbooks and Desired State Configuration.

Richiesta di un runbook o un moduloRequesting a runbook or module

È possibile inviare richieste a User Voice.You can send requests to User Voice. Se è necessario supporto per la scrittura di un runbook o per inviare domande relative a PowerShell, inserire una domanda nel forum.If you need help writing a runbook or have a question about PowerShell, post a question to our forum.

Passaggi successiviNext Steps