Hibajelentés – Fogalmak

A Windows PowerShell két mechanizmust biztosít a hibák jelentésére: az egyik a hibák megszüntetésére szolgáló mechanizmust, a másik pedig a nem megszüntető hibákmechanizmusát. Fontos, hogy a parancsmag helyesen jelentse a hibákat, hogy a parancsmagokat futtató gazdaalkalmazás megfelelően reagáljon.

A parancsmagnak meg kell hívnia a System.Management.Automation.Cmdlet.ThrowTerminatingError* metódust, ha olyan hiba történik, amely miatt a parancsmag továbbra is feldolgozhatja a bemeneti objektumokat. A parancsmagnak meg kell hívnia a System.Management.Automation.Cmdlet.WriteError metódust, hogy jelentse a nem végződő hibákat, ha a parancsmag folytatni tudja a bemeneti objektumok feldolgozását. Mindkét módszer egy hibarekordot biztosít, amelyet a gazdaalkalmazás a hiba okának vizsgálatára használhat.

Az alábbi irányelveket követve megállapíthatja, hogy egy hiba megszüntető vagy nem végződő hiba-e.

• A hiba egy megszüntető hiba, ha megakadályozza, hogy a parancsmag tovább dolgozza fel az aktuális objektumot, vagy hogy a tartalomtól függetlenül sikeresen feldolgozhassa a további bemeneti objektumokat.

• Ha nem szeretné, hogy a parancsmag továbbra is feldolgozhassa az aktuális objektumot vagy bármely további bemeneti objektumot, a tartalomtól függetlenül megszűnik a hiba.

• A hiba egy megszüntető hiba, ha olyan parancsmagban fordul elő, amely nem fogad el vagy ad vissza objektumot, vagy ha olyan parancsmagban fordul elő, amely csak egy objektumot fogad el vagy ad vissza.

• A hiba nem végződő hiba, ha azt szeretné, hogy a parancsmag folytassa az aktuális objektum és a további bemeneti objektumok feldolgozását.

• A hiba nem végződő hiba, ha egy adott bemeneti objektumhoz vagy bemeneti objektumok részhalmazához kapcsolódik.

Lásd még:

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

Windows PowerShell-hibarekordok

Windows PowerShell-parancsmag írása