Begrepp relaterade till felrapportering

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

Cmdleten ska anropa metoden System.Management.Automation.Cmdlet.Throwterminatingerror* när ett fel uppstår som inte tillåter eller inte tillåter cmdleten att fortsätta 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 innehå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 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 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 accepterar eller returnerar endast 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