Pojęcia dotyczące raportowania błędów

  • Artykuł

Windows PowerShell udostępnia dwa mechanizmy raportowania błędów: jeden mechanizm do przerywania błędów i inny mechanizm błędów niepowiązywających się z błędami. Ważne jest, aby polecenie cmdlet poprawnie zgłaszało błędy, aby aplikacja hosta, na których są uruchomione polecenia cmdlet, reagowała w odpowiedni sposób.

Polecenie cmdlet powinno wywołać metodę System.Management.Automation.Cmdlet.Throwterminatingerror*, gdy wystąpi błąd, który nie zezwala lub nie powinien zezwalać na dalsze przetwarzanie obiektów wejściowych przez polecenie cmdlet. Polecenie cmdlet powinno wywołać metodę System.Management.Automation.Cmdlet.WriteError, aby zgłaszać błędy niepowodujące zakończenia, gdy polecenie cmdlet może kontynuować przetwarzanie obiektów wejściowych. Obie metody zawierają rekord błędu, za pomocą których aplikacja hosta może zbadać przyczynę błędu.

Skorzystaj z poniższych wskazówek, aby określić, czy błąd jest błędem kończącym, czy niepowiązywający z tym błędem.

  • Błąd to błąd kończący, jeśli uniemożliwia polecenie cmdlet kontynuowanie przetwarzania bieżącego obiektu lub pomyślne przetwarzanie dowolnych dodatkowych obiektów wejściowych, niezależnie od ich zawartości.

  • Błąd to błąd kończący, jeśli nie chcesz, aby polecenie cmdlet kontynuowało przetwarzanie bieżącego obiektu lub innych obiektów wejściowych, niezależnie od ich zawartości.

  • Błąd jest błędem kończącym, jeśli występuje w poleceniach cmdlet, które nie akceptują ani nie zwracają obiektu, lub jeśli występuje w poleceniach cmdlet, które akceptują lub zwracają tylko jeden obiekt.

  • Błąd to błąd niepowiązywający z zakończeniem, jeśli chcesz, aby polecenie cmdlet kontynuowało przetwarzanie bieżącego obiektu i wszystkich dalszych obiektów wejściowych.

  • Błąd to błąd niepowiązywający z zakończeniem, jeśli jest powiązany z określonym obiektem wejściowym lub podzbiorem obiektów wejściowych.

Zobacz też

System.Management.Automation.Cmdlet.Throwterminatingerror*

System.Management.Automation.Cmdlet.WriteError

Rekordy błędów programu Windows PowerShell

Pisanie polecenia cmdlet programu Windows PowerShell