Begrepp relaterade till felrapportering

Windows PowerShell två mekanismer för att rapportera fel: en mekanism för att avsluta fel och en annan mekanism för icke-avslutande fel. Det är viktigt för cmdleten att rapportera fel korrekt så att värdprogrammet som kör cmdletarna kan reagera på ett lämpligt sätt.

Din cmdlet bör anropa metoden System.Management.Automation.Cmdlet.Throwterminatingerror* när ett fel inträffar som inte tillåter eller inte bör tillåta att cmdleten fortsätter att bearbeta sina indataobjekt. Din cmdlet bör anropa metoden System.Management.Automation.Cmdlet.WriteError för att rapportera icke-avslutande fel när cmdleten kan fortsätta bearbeta indataobjekten. Båda metoderna ger en felpost som värdprogrammet kan använda för att undersöka orsaken till felet.

Använd följande riktlinjer för att avgöra om ett fel är ett avslutande eller icke-avslutande fel.

  • Ett fel är ett avslutande fel om det förhindrar att cmdleten fortsätter att bearbeta det aktuella objektet eller från att bearbeta ytterligare indataobjekt, oavsett deras innehåll.

  • Ett fel är ett avslutande fel om du inte vill att cmdleten ska fortsätta bearbeta det aktuella objektet eller ytterligare indataobjekt, oavsett deras innehåll.

  • Ett fel är ett avslutande fel om det inträffar i en cmdlet som inte accepterar eller returnerar ett objekt eller om det inträffar i en cmdlet som accepterar eller endast returnerar ett objekt.

  • Ett fel är ett icke-avslutande fel om du vill att cmdleten ska fortsätta bearbeta det aktuella objektet och eventuella ytterligare indataobjekt.

  • Ett fel är ett icke-avslutande fel om det är relaterat till ett specifikt indataobjekt eller en delmängd av indataobjekt.

Se även

System.Management.Automation.Cmdlet.Throwterminatingerror*

System.Management.Automation.Cmdlet.WriteError

Windows PowerShell-felposter

Skriva en Windows PowerShell-cmdlet