Conceptos de los informes de errores

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

El cmdlet debe llamar al método System.Management.Automation.Cmdlet.Throwterminatingerror* cuando se produce un error que no permite o no permite que el cmdlet siga procesando sus objetos de entrada. El cmdlet debe llamar al método System.Management.Automation.Cmdlet.WriteError para notificar errores que no terminen cuando el cmdlet pueda 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 siguientes directrices para determinar si un error es un error de terminación o de no terminación.

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

  • Un error es un error de terminación si no desea que el cmdlet siga 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 cualquier otro objeto de entrada.

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

Consulte también

System.Management.Automation.Cmdlet.Throwterminatingerror*

System.Management.Automation.Cmdlet.WriteError

Registros de errores de Windows PowerShell

Escribir un cmdlet de Windows PowerShell