Concetti relativi alla segnalazione di errori

Windows PowerShell fornisce due meccanismi per la segnalazione degli errori: un meccanismo per la terminazione degli errori e un altro per gli errori non di terminazione. È importante per il cmdlet segnalare correttamente gli errori in modo che l'applicazione host che esegue i cmdlet possa reagire in modo appropriato.

Il cmdlet deve chiamare il metodo System.Management.Automation.Cmdlet.Throwterminatingerror* quando si verifica un errore che non consente o meno al cmdlet di continuare a elaborare i relativi oggetti di input. Il cmdlet deve chiamare il metodo System.Management.Automation.Cmdlet.WriteError per segnalare errori non di terminazione quando il cmdlet può continuare a elaborare gli oggetti di input. Entrambi i metodi forniscono un record di errore che l'applicazione host può usare per analizzare la causa dell'errore.

Usare le linee guida seguenti per determinare se un errore è un errore di terminazione o non di terminazione.

• Un errore è un errore che termina se impedisce al cmdlet di continuare a elaborare l'oggetto corrente o di elaborare correttamente altri oggetti di input, indipendentemente dal contenuto.

• Un errore è un errore che termina se non si vuole che il cmdlet continui a elaborare l'oggetto corrente o altri oggetti di input, indipendentemente dal relativo contenuto.

• Un errore è un errore di terminazione se si verifica in un cmdlet che non accetta o restituisce un oggetto o se si verifica in un cmdlet che accetta o restituisce un solo oggetto.

• Un errore è un errore non di terminazione se si vuole che il cmdlet continui a elaborare l'oggetto corrente e altri oggetti di input.

• Un errore è un errore non di terminazione se è correlato a un oggetto di input specifico o a un subset di oggetti di input.

Vedere anche

System.Management.Automation.Cmdlet.Throwterminatingerror*

System.Management.Automation.Cmdlet.WriteError

Record degli errori di Windows PowerShell

Scrittura di un cmdlet di Windows PowerShell