Завершення сценарію в PowerShell

Я шукав спосіб припинити скрипт PowerShell (PS1), коли в функції виникає непоправна помилка. Наприклад:

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

Звичайно, такого немає $host.Exit(). Є $host.SetShouldExit(), але це фактично закриває вікно консолі, а це не те, що я хочу. Мені потрібно щось еквівалентне Python, sys.exit()що просто зупинить виконання поточного сценарію без додаткових зусиль.

Редагувати: Так, це просто exit. Дух.

Ви повинні використовувати в 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. Для отримання додаткової інформації див. Про_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
} 

Я використовував це для повторної програми. Я не знаю, чи це допомогло б, але це просто, якщо заява вимагає лише двох різних записів. Для мене це працювало в силі.

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

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

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