Control de errores para cmdlets de SharePoint Foundation
Última modificación: jueves, 01 de octubre de 2009
Hace referencia a: SharePoint Foundation 2010
Los cmdlets de SharePoint Foundation deben permitir la administración de errores básica. Esto significa que se deben enumerar todas las condiciones en las que un cmdlet puede producir un error y describir el comportamiento esperado para cada condición. Los cmdlets deben limpiar los cambios parciales cuando se produce un error y deben devolver un mensaje de error significativo, que revele de qué forma el administrador puede recuperar el sistema de cualquier condición de error. En particular, los cmdlets deben poder diferenciar entre errores irrecuperables (de terminación) y no graves (de no terminación). Un error irrecuperable es un error que impide que Windows PowerShell procese un comando. Los errores irrecuperables terminan la ejecución de una canalización de Windows PowerShell. Un error de no terminación permite que Windows PowerShell continúe operando en el objeto de entrada actual o en objetos de canalización entrantes posteriores. Asimismo, los errores de no terminación dan al sistema la oportunidad de recuperarse.
Control de errores en cmdlets de SharePoint
Los cmdlets deben tener la capacidad de recuperación suficiente para soportar valores de propiedad no válidos. Si bien en casos irrecuperables un cmdlet Get debe iniciar un error de terminación (por ejemplo, si no se puede conectar a una base de datos específica), debe tratar un objeto que tiene propiedades no válidas como un error de no terminación y escribir dicho objeto a la canalización de salida.
Los cmdlets deben informar todos los errores de no terminación usando el método WriteError(Exception, ErrorCategory, Object). En el caso de errores de terminación, los cmdlets deberían iniciar una excepción localizada.
Tanto los errores de terminación como los de no terminación deben usar cadenas de error localizadas y la configuración regional de subprocesos actual para informar errores cuando se usa el método WriteError(Exception, ErrorCategory, Object).
Nota
No use las API de información de errores Windows PowerShell directamente; use las API de SharePoint Foundation para Windows PowerShell que se encuentran ubicadas en el espacio de nombres Microsoft.SharePoint.PowerShell. Esto garantizará la compatibilidad entre cmdlets que operan en implementaciones de SharePoint. Las API de SharePoint implementan la funcionalidad de las API de Windows PowerShell nativas, pero, lo que es más importante aún, realizan tareas adicionales como escribir datos de errores a archivos de registro.
Vea también
Conceptos
Instrucciones de desarrollo para cmdlets de SharePoint Foundation
Conceptos principales para la escritura de cmdlets de la Consola de administración de SharePoint