Concepten voor foutrapportage

Windows PowerShell biedt twee mechanismen voor het rapporteren van fouten: één mechanisme voor afsluitfouten en een ander mechanisme voor niet-afsluitfouten. Het is belangrijk dat uw cmdlet fouten correct rapporteert, zodat de hosttoepassing waarop uw cmdlets worden uitgevoerd, op de juiste manier kan reageren.

De cmdlet moet de System.Management.Automation.Cmdlet.ThrowTerminatingError* methode aanroepen wanneer er een fout optreedt die de cmdlet niet toestaat om de invoerobjecten te blijven verwerken. De cmdlet moet de methode System.Management.Automation.Cmdlet.WriteError aanroepen om niet-afsluitfouten te melden wanneer de cmdlet de invoerobjecten kan blijven verwerken. Beide methoden bieden een foutrecord die de hosttoepassing kan gebruiken om de oorzaak van de fout te onderzoeken.

Gebruik de volgende richtlijnen om te bepalen of een fout een afsluitfout of een niet-afsluitfout is.

• Een fout is een afsluitfout als uw cmdlet het huidige object niet kan blijven verwerken of geen verdere invoerobjecten meer kan verwerken, ongeacht de inhoud ervan.

• Een fout is een afsluitfout als u niet wilt dat uw cmdlet het huidige object of verdere invoerobjecten blijft verwerken, ongeacht de inhoud ervan.

• Een fout is een afsluitfout als deze optreedt in een cmdlet die een object niet accepteert of retourneert, of als het zich voordoet in een cmdlet die slechts één object accepteert of retourneert.

• Een fout is een niet-afsluitfout als u wilt dat de cmdlet het huidige object en eventuele verdere invoerobjecten blijft verwerken.

• Een fout is een niet-afsluitfout als deze is gerelateerd aan een specifiek invoerobject of een subset van invoerobjecten.

Zie ook

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

Windows PowerShell-foutrecords

Een Windows PowerShell-cmdlet schrijven