Conceitos de relatórios de erro

O Windows PowerShell fornece dois mecanismos para relatar erros: um mecanismo para terminação de erros e outro mecanismo para erros de não terminação. É importante que o cmdlet relate erros corretamente para que o aplicativo host que está executando seus cmdlets possa reagir de maneira apropriada.

Seu cmdlet deve chamar o método System.Management.Automation.Cmdlet.ThrowTerminatingError* quando ocorrer um erro que não permita ou não que o cmdlet continue processando seus objetos de entrada. Seu cmdlet deve chamar o método System.Management.Automation.Cmdlet.WriteError para relatar erros de não terminação quando o cmdlet puder continuar processando os objetos de entrada. Ambos os métodos fornecem um registro de erro que o aplicativo host pode usar para investigar a causa do erro.

Use as diretrizes a seguir para determinar se um erro é um erro de terminação ou não terminação.

• Um erro será um erro de encerramento se ele impedir que o cmdlet continue processando o objeto atual ou processe com êxito quaisquer outros objetos de entrada, independentemente de seu conteúdo.

• Um erro será um erro de encerramento se você não quiser que o cmdlet continue processando o objeto atual ou quaisquer outros objetos de entrada, independentemente do conteúdo.

• Um erro é um erro de encerramento se ocorrer em um cmdlet que não aceita ou retorna um objeto ou se ele ocorre em um cmdlet que aceita ou retorna apenas um objeto.

• Um erro é um erro de não encerramento se você quiser que seu cmdlet continue processando o objeto atual e quaisquer outros objetos de entrada.

• Um erro será um erro de não encerramento se ele estiver relacionado a um objeto de entrada específico ou subconjunto de objetos de entrada.

Consulte Também

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

registros de erro do Windows PowerShell

gravando um cmdlet do Windows PowerShell