Основные понятия, связанные с отчетами об ошибках
Windows PowerShell предоставляет два механизма создания отчетов об ошибках: один механизм прекращения ошибок и другой механизм для неисключающих ошибок. Для командлета важно правильно сообщать об ошибках, чтобы ведущего приложения, выполняющего командлеты, реагировать соответствующим образом.
Командлет должен вызывать метод System.Management.Automation.Командлет.ThrowTerminatingError* при возникновении ошибки, которая не позволяет командлету продолжать обрабатывать входные объекты. Командлет должен вызвать метод System.Management.Automation.Командлет.WriteError, чтобы сообщить об ошибках без конца, когда командлет может продолжить обработку входных объектов. Оба метода предоставляют запись об ошибке, которую может использовать ведущее приложение для изучения причины ошибки.
Используйте следующие рекомендации, чтобы определить, является ли ошибка завершающим или неисключающим ошибкой.
Ошибка — это завершающая ошибка, если он запрещает командлету продолжать обрабатывать текущий объект или успешно обрабатывать любые дополнительные входные объекты независимо от их содержимого.
Ошибка — это завершающая ошибка, если командлет не хочет, чтобы командлет продолжал обрабатывать текущий объект или любые другие входные объекты независимо от их содержимого.
Ошибка является завершающим ошибкой, если она возникает в командлете, который не принимает или не возвращает объект, или если он возникает в командлете, который принимает или возвращает только один объект.
Ошибка — это несрочная ошибка, если вы хотите, чтобы командлет продолжал обрабатывать текущий объект и любые другие входные объекты.
Ошибка — это несрочная ошибка, если она связана с определенным входным объектом или подмножеством входных объектов.
См. также
System.Management.Automation.Командлет.ThrowTerminatingError*
System.Management.Automation.Командлет.WriteError
PowerShell