Konzepte der Fehlerberichterstattung

  • Artikel

Windows PowerShell bietet zwei Mechanismen zum Melden von Fehlern: einen Mechanismus zum Beenden von Fehlern und einen anderen Mechanismus für Fehler ohne Abbruch. Es ist wichtig, dass Ihr Cmdlet Fehler ordnungsgemäß meldet, damit die Hostanwendung, auf der Ihre Cmdlets ausgeführt werden, angemessen reagieren kann.

Ihr Cmdlet sollte die System.Management.Automation.Cmdlet.Throwterminatingerror*-Methode aufrufen, wenn ein Fehler auftritt, der dem Cmdlet nicht erlaubt, die Verarbeitung seiner Eingabeobjekte fortzusetzen. Ihr Cmdlet sollte die System.Management.Automation.Cmdlet.WriteError-Methode aufrufen, um Fehler ohne Abbruch zu melden, wenn das Cmdlet die Verarbeitung der Eingabeobjekte fortsetzen kann. Beide Methoden stellen einen Fehlerdatensatz bereit, mit dem die Hostanwendung die Ursache des Fehlers untersuchen kann.

Verwenden Sie die folgenden Richtlinien, um zu bestimmen, ob es sich bei einem Fehler um einen abschließenden oder nicht abschließenden Fehler handelt.

  • Ein Fehler ist ein fehlerbeendender Fehler, wenn er verhindert, dass Ihr Cmdlet das aktuelle Objekt weiter verarbeitet oder weitere Eingabeobjekte unabhängig von ihrem Inhalt erfolgreich verarbeitet.

  • Ein Fehler ist ein abschließender Fehler, wenn Sie nicht möchten, dass Ihr Cmdlet das aktuelle Objekt oder weitere Eingabeobjekte unabhängig vom Inhalt weiter verarbeitet.

  • Ein Fehler ist ein abschließender Fehler, wenn er in einem Cmdlet auftritt, das ein Objekt nicht akzeptiert oder zurückgibt, oder wenn er in einem Cmdlet auftritt, das nur ein Objekt akzeptiert oder zurückgibt.

  • Ein Fehler ist ein Fehler ohne Abbruch, wenn Ihr Cmdlet die Verarbeitung des aktuellen Objekts und weiterer Eingabeobjekte fortsetzen soll.

  • Ein Fehler ist ein Fehler ohne Abbruch, wenn er sich auf ein bestimmtes Eingabeobjekt oder eine Teilmenge von Eingabeobjekten bezieht.

Weitere Informationen

System.Management.Automation.Cmdlet.Throwterminatingerror*

System.Management.Automation.Cmdlet.WriteError

Windows PowerShell-Fehlerdatensätze

Schreiben eines Windows PowerShell-Cmdlets