В этом разделе рассматривается отладка скриптов путем пошагового выполнения.
Пошаговое выполнение скрипта — это поочередное выполнение его инструкций. Можно остановить выполнение скрипта на любой строке кода и проверить значения переменных и состояние системы. В следующей таблицы описываются задачи, выполняемые при отладке, такие как переход, вход и выход.
Задача |
Описание |
Способ выполнения в PowerShell ISE |
Войти |
Выполнение текущей инструкции и остановка на следующей инструкции. Если текущая инструкция является вызовом функции или скрипта, отладчик выполняет пошаговый вход в эту функцию или скрипт. В противном случае он останавливается на следующей инструкции. |
В области команд введите "S" и нажмите клавишу ВВОД или откройте меню Отладка и выберите пункт Войти. |
Перейти |
Выполнение текущей инструкции и остановка на следующей инструкции. Если текущая инструкция является вызовом функции или скрипта, отладчик полностью выполняет эту функцию или скрипт и останавливается на инструкции, следующей после этого вызова. |
В области команд введите "V" и нажмите клавишу ВВОД или откройте меню Отладка и выберите пункт Перейти. |
Выйти |
Выход из текущей функции и переход на один уровень выше, если функция является вложенной. Если выполняется тело главной функции, скрипт выполняется до конца или до следующей точки останова. Пропущенные инструкции выполняются, но в них отладчик не останавливается. |
В области команд введите "O" и нажмите клавишу ВВОД или откройте меню Отладка и выберите пункт Выйти. |
Продолжить |
Выполнение продолжается до конца или до следующей точки останова. Пропущенные функции и вызовы выполняются, но в них отладчик не останавливается. |
В области команд введите "C" и нажмите клавишу ВВОД или откройте меню Отладка и выберите пункт Выполнить/продолжить. |
Отладка скриптов
- Установите точки останова в областях кода, которые требуется
проверить. Дополнительные сведения об установке точек останова см.
в разделе How to Set, Remove, Disable Enable, Disable, and List
Breakpoints или Set-PSBreakpoint.
- Откройте меню Отладка и выберите пункт
Выполнить/продолжить или нажмите кнопку Выполнить
скрипт на панели инструментов. Пример:
- Начинается отладка. Скрипт выполняется до
первой точки останова, затем он останавливается. Точка останова
выделяется.
- Командная строка изменяется, и в области
команд появляется префикс [DBG].
- В области вывода отображается сообщение о
встреченной точке останова. Например, «Точка останова строки
"C:\Users\name\Desktop\test.script.ps1:13"».
- Начинается отладка. Скрипт выполняется до
первой точки останова, затем он останавливается. Точка останова
выделяется.
- Теперь можно воспользоваться любой из следующих функций:
"Перейти", "Войти", "Выйти" и "Продолжить". При запуске команды
"Продолжить" отладчик выполняет скрипт до конца или до следующей
точки останова.
- Чтобы узнать значение переменной во время отладки, наведите на
нее курсор мыши в области скриптов или введите ее имя в области
команд и нажмите клавишу ВВОД. В области вывода отобразится
значение переменной. Продолжайте пошаговое выполнение скрипта или
перейдите к другим задачам отладки.