Usare i runbook e i moduli esistenti
Anziché creare runbook e moduli personalizzati in Automazione di Azure, si può ricorrere ad alcuni scenari già creati da Microsoft e dalla community. È possibile ottenere i runbook di PowerShell e Python correlati ad Azure dalla raccolta di runbook nel portale di Azure e moduli e runbook (che potrebbero o non essere specifici di Azure) da PowerShell Gallery. È anche possibile contribuire alla community condividendo gli scenari sviluppati personalmente.
Nota
TechNet Script Center viene ritirato. Tutti i runbook del Centro script nella raccolta di runbook sono stati spostati nell'organizzazione GitHub di Automazione. Per altre informazioni, vedere Automazione di Azure Passaggio dei runbook in GitHub.
Importare runbook da GitHub con il portale di Azure
Nota
- L'opzione Sfoglia raccolta nella portale di Azure offre un'esperienza utente migliorata.
- Nel pannello Runbook di Automazione>processi è possibile importare runbook tramite l'opzione Importa un runbook o Sfoglia raccolta e nella pagina Runbook vengono visualizzate due nuove colonne: versione del runtime e tipo di runbook.
Nel portale di Azure aprire l'account di Automazione.
Selezionare il pannello Runbook in Automazione processi.
Fare clic su Importa un runbook nella pagina Runbook .
Nella pagina Importare un runbook è possibile importare un file archiviato nel computer locale o da GitHub usando rispettivamente Sfoglia per file o Sfoglia dalla raccolta.
Seleziona il file.
Immettere il nome, la versione di runtime e la descrizione.
Fare clic su Importa.
In alternativa, selezionare Sfoglia raccolta nella pagina Runbook per esplorare i runbook disponibili.
È possibile usare i filtri sopra l'elenco per restringere la visualizzazione in base al server di pubblicazione, al tipo e all'ordinamento. Individuare l'elemento della raccolta desiderato e selezionarlo per visualizzarne i dettagli.
Fare clic su Seleziona per selezionare un runbook scelto.
Nella pagina Importa un runbook immettere il nome e selezionare le versioni di runtime.
Il tipo di runbook e la descrizione vengono popolati automaticamente.
Fare clic su Importa.
Il runbook viene visualizzato nella scheda Runbook per l'account di automazione.
Runbook in PowerShell Gallery
Importante
È consigliabile convalidare il contenuto di tutti i runbook che si ottengono da PowerShell Gallery. Prestare particolare attenzione all'installazione e all'esecuzione in un ambiente di produzione.
PowerShell Gallery offre vari runbook di Microsoft e della community che è possibile importare in Automazione di Azure. Per usare un runbook, scaricarne uno dalla raccolta disponibile oppure importare runbook direttamente dalla raccolta o dall'account di automazione nel portale di Azure.
Nota
PowerShell Gallery non supporta i runbook grafici.
È possibile importare solo direttamente da PowerShell Gallery usando il portale di Azure. Non è possibile eseguire questa funzione tramite PowerShell. La procedura è identica a quella illustrata in Importare runbook da GitHub con il portale di Azure, ad eccezione del fatto che l'origine sarà PowerShell Gallery.
Moduli in PowerShell Gallery
I moduli di PowerShell contengono cmdlet che è possibile usare nei runbook. I moduli esistenti che è possibile installare in Automazione di Azure sono disponibili in PowerShell Gallery. È possibile avviare questa raccolta dal portale di Azure e installare i moduli direttamente in Automazione di Azure oppure scaricarli e installarli manualmente.
È anche possibile trovare moduli da importare nella portale di Azure. Sono elencati per l'account di Automazione nei moduliin Risorse condivise.
Importante
Non includere la parola chiave "AzureRm" in uno script progettato per l'esecuzione con il modulo Az. L'inclusione della parola chiave, anche in un commento, può causare il caricamento di AzureRm e quindi il conflitto con il modulo Az.
Scenari comuni disponibili in PowerShell Gallery
L'elenco seguente contiene alcuni runbook che supportano scenari comuni. Per un elenco completo dei runbook creati dal team di Automazione di Azure, vedere il profilo AzureAutomationTeam.
- Update-ModulesInAutomationToLatestVersion: importa la versione più recente di tutti i moduli di un account di automazione da PowerShell Gallery.
- Enable-AzureDiagnostics: configura Diagnostica di Azure e Log Analytics per ricevere i log di Automazione di Azure contenenti lo stato e i flussi del processo.
- Copy-ItemFromAzureVM: copia un file remoto da una macchina virtuale di Windows Azure.
- Copy-ItemToAzureVM : copia un file locale in una macchina virtuale di Azure.
Contribuire alla community
Si consiglia vivamente di contribuire e aiutare a crescere la community Automazione di Azure. Condividere i runbook incredibili creati con la community. I tuoi contributi saranno apprezzati!
Aggiungere un runbook alla raccolta di runbook GitHub
È possibile aggiungere nuovi runbook Di PowerShell o Python alla raccolta di runbook con questo flusso di lavoro gitHub.
Creare un repository pubblico in GitHub e aggiungere il runbook e tutti gli altri file necessari ,ad esempio readme.md, descrizione e così via.
Aggiungere l'argomento
azureautomationrunbookgallery
per assicurarsi che il repository venga individuato dal servizio, in modo che possa essere visualizzato nella raccolta di runbook di Automazione.Se il runbook creato è un flusso di lavoro di PowerShell, aggiungere l'argomento
PowerShellWorkflow
. Se si tratta di un runbook Python 3, aggiungerePython3
. Non sono necessari altri argomenti specifici per i runbook di Azure, ma è consigliabile aggiungere altri argomenti che possono essere usati per la categorizzazione e la ricerca nella raccolta di runbook.Nota
Consultare i runbook esistenti nella raccolta per informazioni su formattazione, intestazioni e tag esistenti che è possibile usare (ad esempio
Azure Automation
oLinux Azure Virtual Machines
).
Per suggerire modifiche a un runbook esistente, inviare una richiesta pull a tale runbook.
Se si decide di clonare e modificare un runbook esistente, è consigliabile assegnare un nome diverso. Se si usa nuovamente il nome precedente, verrà visualizzato due volte nell'elenco della raccolta runbook.
Nota
Attendere almeno 12 ore per la sincronizzazione tra GitHub e la raccolta di runbook di automazione, sia per i runbook aggiornati che per i nuovi runbook.
Aggiungere un runbook di PowerShell alla raccolta di PowerShell
Microsoft consiglia di aggiungere a PowerShell Gallery i runbook ritenuti più utili per gli altri clienti. PowerShell Gallery accetta moduli e script PowerShell. È possibile aggiungere un runbook caricandolo in PowerShell Gallery.
Importare un modulo dalla raccolta Modules nella portale di Azure
Nel portale di Azure aprire l'account di Automazione.
In Risorse condivise selezionare Moduli.
Nella pagina Moduli selezionare Sfoglia raccolta per aprire l'elenco dei moduli.
Nella pagina "Esplora raccolta" è possibile eseguire la ricerca in base ai campi seguenti:
- Nome del modulo
- Tag
- Autore
- Nome della risorsa cmdlet/DSC
Cercare il modulo desiderato e selezionarlo per visualizzarne i dettagli.
Eseguendo il drill-down di un modulo specifico si accede a ulteriori informazioni. Queste informazioni includono un collegamento che riporta alla PowerShell Gallery, le eventuali dipendenze necessarie e tutti i cmdlet o le risorse DSC contenute nel modulo.
Per installare il modulo direttamente in Automazione di Azure, fare clic su Importa.
Nel riquadro Importa è possibile visualizzare il nome del modulo da importare. Se tutte le dipendenze sono installate, il pulsante OK è attivo. Se non sono presenti tutte le dipendenze richieste, è necessario importarle prima di importare il modulo.
Nel riquadro Importa, fare clic su OK per importare il modulo. Durante l'importazione del modulo nell'account, Automazione di Azure estrae i metadati sul modulo e i cmdlet. Questa azione può richiedere alcuni minuti, in quanto occorre estrarre ogni attività.
Si riceverà una notifica iniziale per indicare che è in corso la distribuzione del modulo e un'altra notifica al termine dell'operazione.
Dopo l'importazione del modulo si vedranno le attività disponibili. È possibile usare le risorse del modulo nelle risorse DSC e dei runbook.
Nota
I moduli che supportano solo i componenti di base di PowerShell non sono supportati in automazione di Azure e non sono in grado di essere importati nel portale di Azure o distribuiti direttamente da PowerShell Gallery.
Richiedere un runbook o un modulo
È possibile inviare richieste a User Voice. Se è necessario supporto per la scrittura di un runbook o per inviare domande relative a PowerShell, inserire una domanda sulla pagina delle domande di Domande e risposte Microsoft.
Passaggi successivi
- Per iniziare a usare i runbook di PowerShell, vedere Esercitazione: Creare un runbook di PowerShell.
- Per usare i runbook, vedere Gestire runbook in Automazione di Azure.
- Per altre informazioni sullo scripting di PowerShell, vedere Documentazione di PowerShell.
- Per informazioni di riferimento sui cmdlet di PowerShell, vedere Az.Automation.