Error Reporting Concepts (Conceitos de Comunicação de Erros)

O Windows PowerShell fornece dois mecanismos para relatar erros: um mecanismo para terminando erros e outro mecanismo para erros não terminativos. É importante que seu 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 deva permitir que o cmdlet continue a processar seus objetos de entrada. Seu cmdlet deve chamar o método System.Management.Automation.Cmdlet.WriteError para relatar erros não terminativos 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 encerramento ou não terminação.

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

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

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

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

• Um erro é um erro de não terminação se estiver relacionado a um objeto de entrada específico ou subconjunto de objetos de entrada.

Ver também

System.Management.Automation.Cmdlet.ThrowTerminatingError*

System.Management.Automation.Cmdlet.WriteError

de registros de erro do Windows PowerShell

Escrevendo um cmdlet do Windows PowerShell