about_Throw

РАЗДЕЛ
    about_Throw

КРАТКОЕ ОПИСАНИЕ
    Описание ключевого слова Throw, генерирующего ошибку с 
    завершением работы.

ПОЛНОЕ ОПИСАНИЕ
    Ключевое слово Throw вызывает ошибку с завершением работы. 
    Ключевое слово Throw можно использовать для остановки обработки 
    команды, функции или скрипта. 

    Например, ключевое слово Throw можно использовать в блоке скрипта 
    инструкции If для отклика на условие или в блоке Catch инструкции 
    Try-Catch-Finally. Ключевое слово Throw можно использовать и при 
    декларировании параметров, чтобы сделать параметр функции 
    обязательным. 

    Ключевое слово Throw может выводить любой объект, в том числе 
    строку сообщения для пользователя или объект, вызвавший ошибку. 


 СИНТАКСИС
    Ключевое слово Throw имеет следующий синтаксис:

        throw [<expression>]


    Выражение в синтаксисе Throw является необязательным. Если 
    ключевое слово Throw не входит в блок Catch и не включает 
    выражение, оно генерирует ошибку ScriptHalted.

        C:\PS> throw

        ScriptHalted
        At line:1 char:6
        + throw <<<<
            + CategoryInfo          : OperationStopped: (:) [], RuntimeException
            + FullyQualifiedErrorId : ScriptHalted


    Если ключевое слово Throw используется в блоке Catch без 
    выражения, оно выводит текущее исключение RuntimeException. 
    Дополнительные сведения см. в разделе about_Try_Catch_Finally.


 ИСПОЛЬЗОВАНИЕ КЛЮЧЕВОГО СЛОВА THROW ДЛЯ СТРОКИ
    Необязательным выражением в составе блока Throw может быть 
    строка, как показано в следующем примере: 

        C:\PS> throw "Это ошибка."

        Это ошибка.
        В строке:1 знак:6
        + throw <<<< "Это ошибка."
            + CategoryInfo          : OperationStopped: (This is an error.:String) [], RuntimeException  
            + FullyQualifiedErrorId : Это ошибка.


 ИСПОЛЬЗОВАНИЕ КЛЮЧЕВОГО СЛОВА THROW ДЛЯ ДРУГИХ ОБЪЕКТОВ

    Выражение также может являться объектом, который выводит объект,
    соответствующий процессу PowerShell, как показано в следующем примере.

        C:\PS> throw (get-process powershell)

        System.Diagnostics.Process (powershell)
        At line:1 char:6
        + throw <<<<  (get-process powershell)
            + CategoryInfo          : OperationStopped: (System.Diagnostics.Process (powershell):Process) [], 
                        RuntimeException
            + FullyQualifiedErrorId : System.Diagnostics.Process (powershell)

    Свойство TargetObject объекта ErrorRecord в автоматической 
    переменной $error можно использовать для изучения ошибки.


        C:\PS> $error[0].targetobject

        Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName                                                            
        -------  ------    -----      ----- -----   ------     -- -----------                                                            
            319      26    61016      70864   568     3.28   5548 powershell 
   

    Также с помощью ключевого слова Throw может выводиться объект 
    ErrorRecord или исключение платформы Microsoft.NET Framework. В следующем 
    примере ключевое слово Throw используется для вывода объекта 
    System.FormatException.

        C:\PS> $formatError = new-object system.formatexception

        C:\PS> throw $formatError

        Формат одного из идентифицированных элементов неверен.
        В строке:1 знак:6
        + throw <<<< $formatError
            + CategoryInfo          : OperationStopped: (:) [], FormatException 
        + FullyQualifiedErrorId : Формат одного из идентифицированных элементов неверен.


 ВОЗВРАЩАЕМАЯ ОШИБКА
    Ключевое слово Throw может генерировать объект ErrorRecord. 
    Свойство Exception объекта ErrorRecord содержит объект 
    RuntimeException. Остальная часть объекта ErrorRecord и объекта 
    RuntimeException меняются в зависимости от объекта, выводимого 
    ключевым словом Throw.

    Объект RunTimeException заключается в объект ErrorRecord, а 
    объект ErrorRecord автоматически сохраняется в автоматической 
    переменной $Error


 ИСПОЛЬЗОВАНИЕ КЛЮЧЕВОГО СЛОВА THROW ДЛЯ СОЗДАНИЯ ОБЯЗАТЕЛЬНОГО ПАРАМЕТРА
    Ключевое слово Throw можно использовать для превращения параметра 
    функции в обязательный. 

    Это альтернатива использованию параметра Mandatory ключевого 
    слова Parameter. При использовании параметра Mandatory система 
    требует у пользователя ввести обязательное значение параметра. 
    При использовании ключевого слова Throw команда прекращает работу 
    и выводит запись об ошибке.

    Например, ключевое слово Throw в подвыражении параметра делает 
    параметр Path обязательным параметром функции. 

    В данном случае ключевое слово Throw выводит строку сообщения, 
    однако именно присутствие ключевого слова Throw генерирует ошибку 
    с завершением работы, если параметр Path не указан. Выражение 
    после ключевого слова Throw является необязательным.

        function Get-XMLFiles
        {
            param ($path = $(throw "The Path parameter is required."))
            dir -path $path\* -include *.xml -recurse | sort lastwritetime | ft lastwritetime, attributes, name  -auto
        }


СМ. ТАКЖЕ
    about_Break
    about_Continue
    about_Scope
    about_Trap
    about_Try_Catch_Finally