Conceptos de los informes de errores

Windows PowerShell proporciona dos mecanismos para notificar errores: un mecanismo para errores de terminación y otro mecanismo para errores de no terminación. Es importante que el cmdlet notifique correctamente los errores para que la aplicación host que ejecuta los cmdlets pueda reaccionar de forma adecuada.

El cmdlet debe llamar al método System.Management.Automation.Cmdlet.ThrowTerminatingError* cuando se produce un error que no permite que el cmdlet continúe procesando sus objetos de entrada. El cmdlet debe llamar al método System.Management.Automation.Cmdlet.WriteError para notificar errores de no terminación cuando el cmdlet puede continuar procesando los objetos de entrada. Ambos métodos proporcionan un registro de error que la aplicación host puede usar para investigar la causa del error.

Use las instrucciones siguientes para determinar si un error es un error de terminación o no de terminación.

• Un error es un error de terminación si impide que el cmdlet continúe procesando el objeto actual o procese correctamente los objetos de entrada adicionales, independientemente de su contenido.

• Un error es un error de terminación si no desea que el cmdlet continúe procesando el objeto actual o cualquier otro objeto de entrada, independientemente de su contenido.

• Un error es un error de terminación si se produce en un cmdlet que no acepta o devuelve un objeto o si se produce en un cmdlet que acepta o devuelve solo un objeto.

• Un error es un error de no terminación si desea que el cmdlet siga procesando el objeto actual y los objetos de entrada adicionales.

• Un error es un error de no terminación si está relacionado con un determinado objeto de entrada o subconjunto de objetos de entrada.

Véase también

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

registros de errores de Windows PowerShell

escribir un cmdlet de Windows PowerShell