powershell прервать выполнение скрипта

about_Break

Краткое описание

Подробное описание

break Оператор предоставляет способ выхода из текущего управляющего блока. Выполнение продолжится в следующей инструкции после блока управления. Инструкция поддерживает метки. Метка — это имя, назначаемое оператору в скрипте.

Использование break in Loops

В следующем примере показано, как использовать break оператор для выхода из for оператора:

Чаще используется break оператор в цикле, где должно выполняться внутреннее условие. Рассмотрим следующий foreach пример инструкции:

Использование метки break в цикле

break Перемещает выполнение из цикла с меткой. Во встроенных циклах результат отличается от результата break ключевого слова при его использовании. В этом примере имеется while оператор с for оператором:

Можно вложить много циклов с метками, как показано в следующем примере.

PowerShell не ограничивает, насколько далеко могут возобновить выполнение меток. Метка может даже передавать управление между скриптом и границами вызовов функций.

Использование break в switch операторе

В switch конструкции break заставляет PowerShell выйти из switch блока кода.

break Ключевое слово используется для выхода из switch конструкции. Например, следующая switch инструкция использует break инструкции для проверки наиболее конкретного условия:

Когда PowerShell достигает первого break оператора, switch инструкция завершается. Если четыре break инструкции удаляются из примера, выполняются все четыре условия. В этом примере используется break оператор для вывода результатов при выполнении наиболее конкретного условия.

Использование break в trap операторе

Обратите внимание, что выполнение останавливается при возникновении исключения. After loop Никогда не достигается. Исключение создается повторно после trap выполнения.

Не используйте break за пределами цикла, switch или trap

Это означает, что функции и скрипты, которые случайно используют break вне включающей конструкции, поддерживающей эту функцию, могут случайно завершить свои вызывающие объекты.

Источник

Завершение сценария в PowerShell

Я искал способ завершить сценарий PowerShell (PS1), когда в функции возникает неустранимая ошибка. Например:

10 ответов

Я понимаю, что это старый пост, но я возвращаюсь к этой теме, так как это один из лучших результатов поиска при поиске этой темы. Однако я всегда оставляю более запутанным, чем когда я пришел из-за противоречивой информации. В конечном счете я всегда должен выполнять свои собственные тесты, чтобы выяснить это. Поэтому на этот раз я опубликую свои выводы.

TL; DR большинство людей захотят использовать Exit для завершения запущенных сценариев. Однако, если ваш сценарий просто объявляя функции, которые позже будут использоваться в оболочке, вы захотите использовать Return в определениях указанных функций.

выход vs возвращение vs перерыв

выход: это будет «выход» из текущего контекста. Если вы вызовете эту команду из скрипта, она выйдет из скрипта. Если вы вызовете эту команду из оболочки, она выйдет из оболочки.

если функция вызывает команду Exit, она выйдет из контекста он прибывает. Поэтому, если эта функция вызывается только из запущенного скрипта, она выйдет из этого скрипта. Однако, если ваш скрипт просто объявляет функцию, чтобы ее можно было использовать из текущей оболочки, и вы запускаете эту функцию из оболочки, она выйдет из оболочки, потому что оболочка-это контекст, в котором функция contianing работает.

Примечание: по умолчанию, если вы щелкните правой кнопкой мыши на скрипте, чтобы запустить его в PowerShell, как только скрипт выполняется, PowerShell автоматически закрывается. Это не имеет ничего общего с Exit команда или что-нибудь еще в вашем скрипте. Это просто поведение PowerShell по умолчанию для сценариев, выполняемых с использованием этого конкретного метода запуска сценария. То же самое верно для пакетных файлов и окна командной строки.

вернуться: это вернется к предыдущей точке вызова. Если вы вызовете эту команду из скрипта (вне любых функций), она вернется к оболочка. Если вы вызовете эту команду из оболочки, она вернется в оболочку (которая является предыдущей точкой вызова для одной команды, запущенной из оболочки). Если вы вызовете эту команду из функции, она вернется туда, откуда была вызвана функция.

перерыв: это вырвется из петель и переключателей. Если вы вызовете эту команду, не находясь в цикле или переключателе, она выйдет из скрипта. Если вы позвоните Break внутри цикла, вложенная в цикл, то это будет только разорвать цикл назывался.

существует также интересная особенность Break где вы можете префикс цикла с меткой, а затем вы можете вырваться из этого помеченного цикла, даже если Break команда вызывается в нескольких вложенных группах внутри этого помеченного цикла.

Источник

Ставим PowerShell скрипт на паузу

Простой прием, позволяющий приостановить выполнение PowerShell скрипта до нажатия пользователем любой клавиши или отменить его совсем.

Для примера создадим скрипт ask.ps1, содержащий вот такой текст:

Write-Host ″Press any key to continue … or Ctrl+C to abort″

Ключевым моментом здесь является конструкция:

В ней мы используем метод ReadKey свойства RawUI, являющееся свойством UI, которое в свою очередь является свойством переменной среды $host, хранящей текущий сеанс PowerShell. Для ReadKey мы указываем следующие параметры:

IncludeKeyDown — этот параметр обеспечивает продолжение работы скрипта в том случае, если будет нажата какая-либо клавиша. Как вариант, можно использовать параметр IncludeKeyUp, в этом случае работа скрипта продолжится только после того, как клавиша будет отпущена.
NoEcho — предотвращает вывод на экран лишней информации.

Запускаем скрипт, и получаем возможность либо продолжить выполнение при нажатии любой клавиши, либо отменить сочетанием клавиш Ctrl+C.

Важно. Данный трюк не работает в PowerShell ISE.

В приведенном примере у пользователя есть возможность отменить выполнение скрипта. Если вы не хотите предоставлять пользователю эту возможность, то надо добавить параметр AllowCtrlC:

В этом случае даже при нажатии клавиш Ctrl+C скрипт будет выполнен.

Источник

Завершение скрипта в PowerShell

Я искал способ завершить сценарий PowerShell (PS1), когда в функции возникает неисправимая ошибка. Например:

Я понимаю, что это старая запись, но я часто возвращаюсь к этой теме, так как это один из лучших результатов поиска при поиске по этой теме. Однако я всегда оставляю более смущенным, чем когда приходил из-за противоречивой информации. В конечном счете, я всегда должен выполнять свои собственные тесты, чтобы понять это. Так что на этот раз я опубликую свои выводы.

TL; DR Большинство людей захотят использовать Exit для завершения запущенных скриптов. Однако, если ваш скрипт просто объявляет функции, которые впоследствии будут использоваться в оболочке, вы захотите использовать их Return в определениях указанных функций.

Выход против возврата против перерыва

Выход: это «выйдет» из текущего запущенного контекста. Если вы вызываете эту команду из скрипта, он выйдет из скрипта. Если вы вызовете эту команду из оболочки, она выйдет из оболочки.

Примечание. По умолчанию, если щелкнуть правой кнопкой мыши сценарий, чтобы запустить его в PowerShell, после его запуска PowerShell автоматически закроется. Это не имеет ничего общего с Exit командой или чем-то еще в вашем скрипте. Это просто поведение PowerShell по умолчанию для сценариев, запускаемых с использованием этого конкретного метода запуска сценария. То же самое верно для командных файлов и окна командной строки.

Возврат: возврат к предыдущему пункту вызова. Если вы вызовете эту команду из скрипта (вне каких-либо функций), она вернется в оболочку. Если вы вызовете эту команду из оболочки, она вернется в оболочку (которая является предыдущей точкой вызова для одной команды, запущенной из оболочки). Если вы вызываете эту команду из функции, она вернется туда, откуда была вызвана функция.

Перерыв: это вырвется из петель и переключит дела. Если вы вызываете эту команду, не находясь в цикле или переключении, она выйдет из сценария. Если вы вызываете Break внутри цикла, который вложен в цикл, он будет прерываться только из цикла, в котором он был вызван.

Существует также интересная особенность, заключающаяся в том, что Break вы можете добавить префикс цикла к метке, а затем выйти из этого помеченного цикла, даже если Break команда вызывается внутри нескольких вложенных групп в этом помеченном цикле.

Источник

about_Scripts

Краткое описание

Описание запуска и записи скриптов в PowerShell.

Подробное описание

Выполнение сценария во многом похоже на выполнение командлета. Введите путь и имя файла скрипта и используйте параметры для отправки данных и задания параметров. Сценарии можно запускать на компьютере или в удаленном сеансе на другом компьютере.

Написание сценария сохраняет команду для последующего использования и упрощает совместное использование с другими пользователями. Что самое важное, это позволяет выполнять команды просто путем ввода пути скрипта и имени файла. Скрипты могут быть простыми как одной командой в файле, так и сложной программой.

Сценарии имеют дополнительные функции, такие как #Requires Специальный комментарий, использование параметров, поддержка разделов данных и цифровая подпись для обеспечения безопасности. Также можно написать разделы справки для скриптов и для любых функций в скрипте.

Выполнение сценария

перед запуском скрипта на Windows необходимо изменить политику выполнения PowerShell по умолчанию. политика выполнения не применяется к PowerShell, работающему на платформах, отличных от Windows.

Политика выполнения по умолчанию Restricted предотвращает выполнение всех скриптов, включая скрипты, которые вы пишете на локальном компьютере. Подробнее см. в разделе about_Execution_Policies.

Политика выполнения сохраняется в реестре, поэтому ее необходимо изменить только один раз на каждом компьютере.

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

В командной строке введите:

Изменение вступает в силу немедленно.

Чтобы выполнить сценарий, введите полное имя файла скрипта и полный путь к нему.

Например, чтобы запустить сценарий Get-ServiceLog.ps1 в каталоге C:\Scripts, введите:

Например, чтобы запустить сценарий ServicesLog.ps1 в локальном каталоге, введите:

Если у скрипта есть параметры, введите параметры и значения параметров после имени файла скрипта.

Например, следующая команда использует параметр ServiceName скрипта Get-ServiceLog, чтобы запросить журнал действия службы удаленного управления Windows.

В качестве функции безопасности PowerShell не выполняет сценарии при двойном щелчке значка скрипта в проводнике или при вводе имени сценария без полного пути, даже если сценарий находится в текущем каталоге. Дополнительные сведения о выполнении команд и сценариев в PowerShell см. в разделе about_Command_Precedence.

Запуск с помощью PowerShell

Начиная с PowerShell 3,0 можно запускать сценарии из проводника.

Чтобы использовать функцию «Запуск с помощью PowerShell», сделайте следующее:

Запустите проводник, щелкните правой кнопкой мыши имя файла скрипта и выберите команду «запустить с помощью PowerShell».

Функция «запустить с помощью PowerShell» предназначена для выполнения скриптов, которые не имеют обязательных параметров и не возвращают выходные данные в командную строку.

Дополнительные сведения см. в разделе about_Run_With_PowerShell.

Выполнение сценариев на других компьютерах

Чтобы запустить сценарий на одном или нескольких удаленных компьютерах, используйте параметр FilePath Invoke-Command командлета.

Следующая команда запускает Get-ServiceLog.ps1 сценарий на удаленных компьютерах с именем Server01 и Server02.

Получить справку по сценариям

Командлет Get-Help получает разделы справки для скриптов, а также для командлетов и других типов команд. Чтобы получить раздел справки для скрипта, введите, Get-Help за которым следует путь и имя файла скрипта. Если путь к скрипту находится в Path переменной среды, путь можно опустить.

Например, чтобы получить справку по сценарию ServicesLog.ps1, введите:

Написание сценария

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

Следующий пример представляет собой простой сценарий, который получает службы, работающие в текущей системе, и сохраняет их в файл журнала. Имя файла журнала создается с текущей даты.

Параметры в скриптах

Чтобы определить параметры в скрипте, используйте инструкцию param. Param Инструкция должна быть первой инструкцией в скрипте, за исключением комментариев и любых #Require инструкций.

Параметры сценария работают как параметры функции. Значения параметров доступны для всех команд в скрипте. Все функции параметров функций, включая атрибут Parameter и его именованные аргументы, также допустимы в скриптах.

При выполнении скрипта пользователи заменяют параметры после имени скрипта.

Чтобы выполнить этот скрипт, введите имя параметра после имени скрипта. Пример:

Дополнительные сведения о инструкции Param и параметрах функции см. в разделе about_Functions и about_Functions_Advanced_Parameters.

Написание справки для сценариев

Раздел справки для скрипта можно написать с помощью любого из двух следующих методов.

Comment-Based справки по сценариям

Создайте раздел справки, используя специальные ключевые слова в комментариях. Чтобы создать справку на основе комментариев для сценария, необходимо поместить комментарии в начало или в конец файла скрипта. Дополнительные сведения о справке на основе комментариев см. в разделе about_Comment_Based_Help.

XML-Based справки по сценариям

Создайте раздел справки на основе XML, например тип, который обычно создается для командлетов. При преобразовании разделов справки на несколько языков требуется справка на основе XML.

Чтобы связать скрипт с разделом справки на основе XML, используйте. Ключевое слово комментария справки Екстерналхелп. Дополнительные сведения о ключевом слове Екстерналхелп см. в разделе about_Comment_Based_Help. Дополнительные сведения о справке на основе XML см. в разделе как написать справку по командлетам.

Возврат значения выхода

Область скрипта и источники с точкой

Каждый скрипт выполняется в отдельной области. Функции, переменные, псевдонимы и диски, созданные в сценарии, существуют только в области скрипта. Доступ к этим элементам или их значениям в области, в которой выполняется скрипт, невозможен.

Чтобы выполнить скрипт в другой области, можно указать область, например Global или local, или создать точку для скрипта.

Функция «с точкой» позволяет запускать скрипт в текущей области, а не в области скрипта. При запуске скрипта, который имеет точку с точкой, команды в скрипте выполняются так, будто были введены в командной строке. Функции, переменные, псевдонимы и диски, создаваемые сценарием, создаются в области, в которой выполняется работа. После выполнения скрипта можно использовать созданные элементы и получить доступ к их значениям в сеансе.

Чтобы создать точку скрипта для исходного кода, введите точку (.) и пробел перед путем к сценарию.

или диспетчер конфигурации служб

После UtilityFunctions.ps1 выполнения скрипта функции и переменные, создаваемые сценарием, добавляются в текущую область.

Дополнительные сведения об области действия см. в разделе about_Scopes.

Скрипты в модулях

Модуль — это набор связанных ресурсов PowerShell, которые можно распространять как единое целое. Вы можете использовать модули для организации скриптов, функций и других ресурсов. Можно также использовать модули для распространения кода среди других пользователей и получения кода из надежных источников.

Можно включить скрипты в модули или создать модуль скрипта, который представляет собой модуль, полностью или в основном содержащий скрипт и вспомогательные ресурсы. Модуль скрипта — это просто сценарий с расширением файла PSM1.

Дополнительные сведения о модулях см. в разделе about_Modules.

Другие функции сценариев

В PowerShell есть много полезных функций, которые можно использовать в скриптах.

#Requires — Можно использовать #Requires инструкцию, чтобы предотвратить выполнение скрипта без указанных модулей или оснасток и заданную версию PowerShell. Дополнительные сведения см. в разделе about_Requires.

$PSCommandPath — Содержит полный путь и имя выполняемого скрипта. Этот параметр допустим во всех скриптах. Эта автоматическая переменная появилась в PowerShell 3,0.

Пскоммандпас содержит полный путь и имя скрипта, который вызывал или вызывает текущий скрипт.

PSScriptRoot содержит каталог скрипта, вызвавшего или вызвавшего текущий скрипт.

Разделы данных. Вы можете использовать Data ключевое слово для разделения данных из логики в скриптах. Разделы данных также могут упростить локализацию. Дополнительные сведения см. в разделе about_Data_Sections и about_Script_Internationalization.

Подпись скрипта. Вы можете добавить цифровую подпись к сценарию. В зависимости от политики выполнения можно использовать цифровые подписи для ограничения выполнения скриптов, которые могут включать ненадежные команды. Дополнительные сведения см. в разделе about_Execution_Policies и about_Signing.

Источник