Dela via


Begrepp relaterade till felrapportering

Windows PowerShell innehåller två mekanismer för att rapportera fel: en mekanism för avslutande fel och en annan mekanism för fel som inte avslutas. Det är viktigt att cmdleten rapporterar fel korrekt så att värdprogrammet som kör dina cmdletar kan reagera på ett lämpligt sätt.

Din cmdlet ska anropa metoden System.Management.Automation.Cmdlet.ThrowTerminatingError* när ett fel inträffar som inte tillåter att cmdleten fortsätter att bearbeta sina indataobjekt. Din cmdlet ska 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 tillhandahåller 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 hindrar din cmdlet från att fortsätta 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 eventuella 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 endast accepterar eller 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