PowerShell \u00e8 il principale linguaggio di scripting e riga di comando utilizzato dai sistemi operativi Windows. Consente di eseguire programmi e attivit\u00e0 di gestione del sistema da terminale ed \u00e8 ampiamente utilizzato da amministratori di sistema e sviluppatori per automatizzare i loro flussi di lavoro.<\/p>\n
La gestione degli errori \u00e8 una parte importante di qualsiasi sistema di scripting e automazione<\/a>. Se qualcosa va storto, i tuoi script PowerShell non dovrebbero semplicemente bloccarsi: dovrebbero identificare che si \u00e8 verificato un errore e intervenire per eseguire nuovamente l’operazione o per avvisarti che qualcosa \u00e8 andato storto in modo che tu possa trovare la causa e risolvere il problema.<\/p>\n Questa guida si propone di fornirti una comprensione dettagliata della gestione degli errori Powershell<\/strong>, compresi i tipi di errori, le tecniche di gestione degli errori, gli esempi di come implementare la gestione degli errori nei tuoi script e le best practice per lanciare, catturare, registrare e rispondere agli errori.<\/p>\n Esistono due tipi di errore che devi gestire in modo diverso per garantire l’affidabilit\u00e0 dei tuoi script PowerShell.<\/p>\n I terminating error<\/a> (errori di terminazione) interrompono l’esecuzione del comando o dello script quando si verificano. Di solito si tratta di eccezioni<\/a>, che possono essere gestite con i blocchi try\/catch (spiegati pi\u00f9 avanti in questo articolo). Le cause dei terminating error includono errori di sintassi (quando sbagli a digitare un comando o fornisci parametri non validi) ed errori interni all’applicazione o al comando in esecuzione.<\/p>\n I non-terminating error<\/a> (errori non di terminazione) non interrompono l’esecuzione del comando o dello script: lo script PowerShell continuer\u00e0 a essere eseguito dopo il verificarsi dell’errore. Di solito, i non-terminating error mostrano un messaggio di errore prima che l’esecuzione riprenda e devono essere gestiti in modo diverso dai terminating error, in modo che non causino il malfunzionamento degli script se il loro output previsto viene richiesto in seguito. Gli errori non-terminating possono essere causati da timeout di rete, file mancanti o problemi di autorizzazioni che, pur non rappresentando un’eccezione o un errore critico nell’esecuzione in s\u00e9, se non vengono gestiti, possono causare un comportamento indesiderato.<\/p>\n Gli errori PowerShell di tipo terminating e le eccezioni vengono lanciati<\/em> (si verifica l’errore) e catturati<\/em> (viene eseguito il codice per gestire l’errore). Gli errori non catturati<\/em> causano l’interruzione dell’esecuzione dello script Powershell. Incapsulando il codice in blocchi try<\/strong>, catch<\/strong> e finally<\/strong><\/a>, puoi gestire questo tipo di errori.<\/p>\n Se il codice eseguito in un blocco try<\/strong> lancia un errore, il blocco di codice nel blocco catch<\/strong> corrispondente verr\u00e0 eseguito per gestire l’errore (permettendo all’esecuzione di continuare, se possibile). Qualsiasi operazione di pulizia che desideri eseguire, indipendentemente dal fatto che si sia verificato o meno un errore, pu\u00f2 essere aggiunta a un blocco finally<\/strong>. Questo viene spiegato meglio con un esempio di codice completo pi\u00f9 avanti in questa pagina.<\/p>\n La gestione degli errori non-terminating<\/a> avviene in modo diverso, poich\u00e9 un errore non viene lanciato per interrompere l’esecuzione e quindi non pu\u00f2 essere catturato. L’errore viene invece memorizzato nella variabile $Error<\/strong>, un array di errori a cui puoi accedere in qualsiasi punto degli script PowerShell per vedere se un’istruzione precedente ha generato un errore non-terminating, come mostrato in questo esempio:<\/p>\n Get-ChildItem -Path “C:\\fake_path”<\/strong><\/p>\n if ($Error) {<\/strong><\/p>\n Write-Host “Error occurred: $($Error[0])” # Visualizza l’errore pi\u00f9 recente come stringa<\/strong><\/p>\n $Error.Clear() # Cancella l’errore<\/strong><\/p>\n }<\/strong><\/p>\n Sopra, il comando Get-ChildItem<\/a> di PowerShell genera un errore non-terminating se il percorso del filesystem fornito non esiste (in questo caso C:\\fake_path<\/strong>). L’errore viene registrato nella variabile $Error, che viene poi controllata e gestita.<\/p>\n Se vuoi assegnare l’output di errore di un particolare comando a una variabile personalizzata, puoi usare il parametro -ErrorVariable<\/strong> (tieni presente che in questo caso la variabile error non \u00e8 un array):<\/p>\n Get-ChildItem -Path “C:\\fake_path” -ErrorVariable customError<\/strong><\/p>\n if ($customError) {<\/strong><\/p>\n Write-Host “Error occurred: $customError” # Visualizza l’errore come una stringa<\/strong><\/p>\n }<\/strong><\/p>\n Puoi anche trasformare gli errori non-terminating in errori terminating e gestirli con blocchi try\/catch. Lo puoi fare per ogni errore non-terminating incontrato nello script, impostando il parametro globale $ErrorActionPreference<\/strong><\/a> su Stop<\/strong>:<\/p>\n $ErrorActionPreference = “Stop”<\/p>\n Oppure, se vuoi farlo solo per gli errori di un singolo comando, puoi impostare il parametro -ErrorAction<\/strong>:<\/p>\n Get-ChildItem -Path “C:\\fake_path” -ErrorAction Stop<\/strong><\/p>\n Di seguito \u00e8 riportato un esempio di script PowerShell che chiarisce la sintassi e la struttura dei blocchi try\/catch\/finally, e mostra come utilizzare pi\u00f9 blocchi catch per diversi tipi di eccezione e come utilizzare un blocco finally per ripulire e gestire eventuali errori residui. Innanzitutto, ecco un singolo errore gestito con un blocco try\/catch:<\/p>\n try {<\/strong><\/p>\n # Tenta di eseguire un\u2019operazione su file che fallisce<\/strong><\/p>\n Get-Content -Path “C:\\fake_path\\fake_file.txt” -ErrorAction Stop<\/strong><\/p>\n } catch {<\/strong><\/p>\n Write-Host “Exception caught: $($_.Exception.Message)”<\/strong><\/p>\n }<\/strong><\/p>\n Puoi anche gestire pi\u00f9 tipi diversi di potenziali errori in un singolo blocco try<\/strong>, gestendo ciascuno con il proprio blocco catch<\/strong>:<\/p>\n try {<\/strong><\/p>\n # Ciascuno dei comandi seguenti lancer\u00e0 un errore terminating di tipo diverso<\/strong><\/p>\n Get-Content -Path “C:\\fake_path\\fake_file.txt” -ErrorAction Stop # Tentativo di operazione su file che non riesce a lanciare una ItemNotFoundException<\/strong><\/p>\n $null.fakeFunction() # Tentativo di eseguire un metodo inesistente su un oggetto null per lanciare una RuntimeException<\/strong><\/p>\n $divideZero = 1\/0 # Divide per zero per lanciare un’eccezione che non sar\u00e0 catturata in modo specifico<\/strong><\/p>\n } catch [System.Management.Automation.ItemNotFoundException] { # Cattura l’errore specifico lanciato da Get-Content<\/strong><\/p>\n Write-Host “Item not found exception caught: $($_.Exception.Message)”<\/strong><\/p>\n } catch [System.Management.Automation.RuntimeException] { # Cattura l’errore specifico lanciato da $null.fakeFunction<\/strong><\/p>\n Write-Host “Runtime exception caught: $($_.Exception.Message)”<\/strong><\/p>\n } catch { # Cattura tutti gli altri errori<\/strong><\/p>\n # Blocco generale di cattura per qualsiasi altra eccezione<\/strong><\/p>\n Write-Host “General exception caught: $($_.Exception.Message)”<\/strong><\/p>\n } finally { # Il blocco finally viene sempre eseguito, indipendentemente dal fatto che sia stata lanciata un’eccezione o meno.<\/strong><\/p>\n Write-Host “Executing the finally block.”<\/strong><\/p>\n $Error.Clear() # Questo potrebbe essere usato, per esempio, per ripulire gli errori non-terminating.<\/strong><\/p>\n }<\/strong><\/p>\n Lo scopo di ogni istruzione \u00e8 spiegato nel codice, in modo da permetterti di vedere il contesto completo di come le istruzioni try<\/strong>, catch<\/strong> e finally<\/strong> lavorano insieme. Tieni presente che se si verificano pi\u00f9 errori terminating nello stesso blocco try<\/strong>, solo il primo errore verr\u00e0 catturato e gestito, e poi verr\u00e0 eseguito il blocco finally<\/strong>. Una volta risolto questo errore, gli errori successivi verranno catturati durante l’esecuzione dello script.<\/p>\n \u00c8 anche possibile annidare i blocchi try\/catch, in modo che gli errori “salgano” attraverso di essi. Ci\u00f2 ti consente di gestire errori specifici nei blocchi try\/catch interni e di gestire qualsiasi errore non catturato o rilanciato, anche quelli all’interno dei blocchi catch<\/strong> interni, nei blocchi esterni. Per esempio, potresti usare blocchi annidati per gestire errori specifici e poi usare un singolo blocco esterno per catturare e registrare tutti gli errori, invece di ripetere il codice per registrarli in ogni blocco interno.<\/p>\n try { # Inizio del blocco esterno di cattura<\/strong><\/p>\n try { # Inizio del blocco interno di cattura<\/strong><\/p>\n # Inserisci qui il codice potenzialmente causa di errori<\/strong><\/p>\n Get-Content -Path “C:\\fake_path\\fake_file.txt” -ErrorAction Stop<\/strong><\/p>\n } catch [System.Management.Automation.ItemNotFoundException] { # Dichiarazione di catch per il blocco catch interno che gestisce specificamente ItemNotFoundException<\/strong><\/p>\n Write-Host “Inner try block file not found exception caught: $($_.Exception.Message)”<\/strong><\/p>\n } catch { # Dichiarazione di cattura per il blocco catch interno che gestisce tutte le altre eccezioni<\/strong><\/p>\n Write-Host “Inner try block exception caught: $($_.Exception.Message)”<\/strong><\/p>\n throw # Lancia nuovamente l’eccezione, in modo che arrivi al blocco try\/catch esterno<\/strong><\/p>\n }<\/strong><\/p>\n } catch { # Dichiarazione di cattura per il blocco catch esterno<\/strong><\/p>\n Write-Host “Outer try block exception caught: $($_.Exception.Message)” # Gestisce tutti gli errori rilanciati nei blocchi interni di catch qui per le attivit\u00e0 di pulizia, registrazione e avviso<\/strong><\/p>\n }<\/strong><\/p>\n Nell’esempio precedente, l’eccezione ItemNotFoundException<\/strong> non viene rilanciata, quindi non verr\u00e0 catturata dal blocco catch esterno.<\/p>\n Quando iniziani a espandere gli script PowerShell per coprire i tuoi specifici casi d’uso, \u00e8 probabile che tu voglia essere in grado di introdurre eccezioni e record di errore<\/a>PowerShell personalizzati:<\/p>\n try {<\/strong><\/p>\n $customException = New-Object Exception “This is a custom error!” # Crea e lancia un errore personalizzato<\/strong><\/p>\n # Crea un record di errore personalizzato<\/strong><\/p>\n $customErrorRecord = New-Object System.Management.Automation.ErrorRecord (<\/strong><\/p>\n $customException,<\/strong><\/p>\n “CustomErrorID”,<\/strong><\/p>\n [System.Management.Automation.ErrorCategory]::NotSpecified, # Imposta la categoria ErrorRecord a NotSpecified<\/strong><\/p>\n $null # Non specifica un oggetto di destinazione specifico per questo errore<\/strong><\/p>\n )<\/strong><\/p>\n throw $customErrorRecord<\/strong><\/p>\n } catch {<\/strong><\/p>\n # Cattura e gestisce il record di errore personalizzato<\/strong><\/p>\n Write-Host “Error Message: $($_.Exception.Message)”<\/strong><\/p>\n Write-Host “Error ID: $($_.FullyQualifiedErrorId)”<\/strong><\/p>\n }<\/strong><\/p>\n Sopra, puoi notare che non \u00e8 stato specificato alcun oggetto di destinazione (poich\u00e9 \u00e8 impostato su $null<\/strong>). Potresti invece sostituirlo con un percorso di file o un altro riferimento e aggiungere ulteriori dettagli al testo dell’eccezione per rendere l’errore personalizzato pi\u00f9 informativo.<\/p>\n Esistono diverse best practice da seguire quando scrivi gli script PowerShell, per garantire una gestione efficace degli errori:<\/p>\n La gestione degli errori \u00e8 una caratteristica importante dello scripting PowerShell ed \u00e8 utile per sviluppare le tue capacit\u00e0 di scripting e automazione. L’implementazione corretta della gestione degli errori, compreso il lancio corretto degli errori, l’uso di blocchi try\/catch\/finally e l’utilizzo di $ErrorActionPreference, ti aiuter\u00e0 a padroneggiare la sintassi di PowerShell<\/a> e a comprendere meglio i problemi incontrati dagli script, aiutandoti cos\u00ec a gestirli meglio.<\/p>\n","protected":false},"excerpt":{"rendered":" PowerShell \u00e8 il principale linguaggio di scripting e riga di comando utilizzato dai sistemi operativi Windows. Consente di eseguire programmi e attivit\u00e0 di gestione del sistema da terminale ed \u00e8 ampiamente utilizzato da amministratori di sistema e sviluppatori per automatizzare i loro flussi di lavoro. La gestione degli errori \u00e8 una parte importante di qualsiasi […]<\/p>\n","protected":false},"author":89,"featured_media":269617,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"no","_lmt_disable":"","footnotes":""},"categories":[4354],"tags":[],"class_list":["post-276233","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-operazioni-it"],"acf":[],"modified_by":"Sergio Oricci","_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/276233","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/users\/89"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/comments?post=276233"}],"version-history":[{"count":0,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/276233\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/media\/269617"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/media?parent=276233"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/categories?post=276233"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/tags?post=276233"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Capire i tipi di errore in PowerShell<\/h2>\n
Concetti di base sulla gestione degli errori PowerShell (try, catch, finally e $ErrorActionPreference)<\/h2>\n
Implementare i blocchi try\/catch\/finally in PowerShell<\/h2>\n
Tecniche avanzate di gestione degli errori PowerShell ed esempi<\/h2>\n
Le best practice nella gestione degli errori PowerShell<\/h2>\n
\n