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

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

function foo() {
    # Do stuff that causes an error
    $host.Exit()
}

Конечно, нет такой вещи как $host.Exit(). Есть $host.SetShouldExit(), но это на самом деле закрывает окно консоли, а это не то, что я хочу. То, что мне нужно, это что-то эквивалентное Python, sys.exit()которое просто остановит выполнение текущего скрипта без дополнительной информации.

Редактировать: Да, это просто exit. Duh.

Вы должны использовать в exitключевое слово .

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

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

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

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

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

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

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

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

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

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

  While ($true) {
      # Code here will run
  
      :myLabel While ($true) {
          # Code here will run
  
          While ($true) {
              # Code here will run
  
              While ($true) {
                  # Code here will run
                  Break myLabel
                  # Code here will not run
              }
  
              # Code here will not run
          }
  
          # Code here will not run
      }
  
      # Code here will run
  }

Exitвыйдет из PowerShell тоже. Если вы хотите «вырваться» из текущей функции или скрипта - используйте Break:)

If ($Breakout -eq $true)
{
     Write-Host "Break Out!"
     Break
}
ElseIf ($Breakout -eq $false)
{
     Write-Host "No Breakout for you!"
}
Else
{
    Write-Host "Breakout wasn't defined..."
}

Write-Error - для ошибок, не заканчивающихся, а throw - для ошибок завершения.

Командлет Write-Error объявляет нескончаемую ошибку. По умолчанию ошибки передаются в потоке ошибок в ведущую программу для отображения вместе с выводом.

Не прекращающиеся ошибки записывают ошибку в поток ошибок, но не останавливают обработку команд. Если для одного элемента в коллекции входных элементов объявляется нескончаемая ошибка, команда продолжает обрабатывать другие элементы в коллекции.

Чтобы объявить завершающую ошибку, используйте ключевое слово Throw. Для получения дополнительной информации см. About_Throw ( http://go.microsoft.com/fwlink/?LinkID=145153 ).

Завершает этот процесс и дает базовой операционной системе указанный код выхода.

https://msdn.microsoft.com/en-us/library/system.environment.exit%28v=vs.110%29.aspx

[Environment]::Exit(1)

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

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

Создание исключения будет хорошо, особенно если вы хотите выяснить причину ошибки:

throw "Error Message"

Это сгенерирует завершающую ошибку.

Может быть, лучше использовать «ловушку». Ловушка PowerShell указывает кодовый блок, который запускается при завершении или ошибке. Тип

Get-Help about_trap

чтобы узнать больше об утверждении ловушки.

По совпадению я обнаружил, что (например, просто , когда метка не существует ), кажется, выходит из всего скрипта (даже изнутри функции) и поддерживает работу хоста. Таким образом, вы можете создать функцию, которая разрывает скрипт из любого места (например, рекурсивный цикл), не зная текущей области (и создавая метки):Break <UnknownLabel>Break ScriptScript

Function Quit($Text) {
    Write-Host "Quiting because: " $Text
    Break Script
} 

Я использовал это для перезапуска программы. Я не знаю, поможет ли это, но это простой оператор if, требующий только двух разных записей. Это работает в PowerShell для меня.

$rerun = Read-Host "Rerun report (y/n)?"

if($rerun -eq "y") { Show-MemoryReport }
if($rerun -eq "n") { Exit }

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