Koncepty zasílání zpráv o chybách

Windows PowerShell poskytuje dva mechanismy pro hlášení chyb: jeden mechanismus pro ukončování chyb a další mechanismus pro neukončující chyby. Je důležité, aby vaše rutina správně hlásila chyby, aby hostitelská aplikace, která spouští vaše rutiny, správně reagovala.

Rutina by měla volat metodu System.Management.Automation.Cmdlet.ThrowTerminatingError*, pokud dojde k chybě, která ne, nebo by neměla rutině umožnit pokračovat ve zpracování vstupních objektů. Rutina by měla volat metodu System.Management.Automation.Cmdlet.WriteError, která hlásí neukončující chyby, když rutina může pokračovat ve zpracování vstupních objektů. Obě metody poskytují záznam o chybě, který může hostitelská aplikace použít ke zkoumání příčiny chyby.

Následující pokyny vám pomůžou určit, jestli je chyba ukončující nebo neukončující.

• Chyba je ukončením chyby, pokud vaší rutině brání v dalším zpracování aktuálního objektu nebo úspěšnému zpracování jakýchkoli dalších vstupních objektů bez ohledu na jejich obsah.

• Chyba je ukončující chyba, pokud nechcete, aby vaše rutina pokračovala ve zpracování aktuálního objektu nebo jakýchkoli dalších vstupních objektů bez ohledu na jejich obsah.

• Chyba je ukončující chyba, pokud se vyskytuje v rutině, která nepřijímá nebo nevrací objekt nebo pokud se vyskytuje v rutině, která přijímá nebo vrací pouze jeden objekt.

• Chyba je neukončující chyba, pokud chcete, aby vaše rutina pokračovala ve zpracování aktuálního objektu a jakýchkoli dalších vstupních objektů.

• Chyba je neukončující chyba, pokud souvisí s konkrétním vstupním objektem nebo podmnožinou vstupních objektů.

Viz také

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

záznamy chyb Windows PowerShellu

psaní rutiny Prostředí Windows PowerShell