Enable-PSBreakpoint (Microsoft.PowerShell.Utility)

Включить-PSBreakpoint

Модуль:: Microsoft.PowerShell.Utility

Включает точки останова в текущей консоли.

Синтаксис

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Enable-PSBreakpoint повторно включает отключенные точки останова. Вы можете использовать его для включения всех точек останова или определенных точек останова, предоставляя объекты или идентификаторы точек останова.

Точка останова — это точка в сценарии, где выполнение временно останавливается, чтобы вы могли проверить состояние сценария. Вновь созданные точки останова включаются автоматически, но их можно отключить с помощью Disable-PSBreakpoint.

Технически этот командлет изменяет значение свойства Enabled объекта точки останова на True.

Enable-PSBreakpoint — один из нескольких командлетов, предназначенных для отладки сценариев PowerShell. Дополнительные сведения об отладчике PowerShell см. в разделе about_Debuggers.

Примеры

Пример 1: включить все точки останова

В этом примере включены все точки останова в текущем сеансе.

Get-PSBreakpoint | Enable-PSBreakpoint

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

Пример 2. Включение точек останова по идентификатору

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

Enable-PSBreakpoint -Id 0, 1, 5

Пример 3. Включение отключенной точки останова

В этом примере повторно включается отключенная точка останова.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint создает точку останова для переменной Name в сценарии Sample.ps1, сохраняя объект точки останова в $B переменная. Параметр PassThru отображает значение свойства Enabled точки останова: False.

Enable-PSBreakpoint повторно включает точку останова. Опять же, используя параметр PassThru, мы видим, что значение свойства Enabled равно True.

Пример 4. Включение точек останова с помощью переменной

В этом примере включается набор точек останова с использованием объектов точек останова.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint получает точки останова и сохраняет их в переменной $B. Используя параметр Breakpoint, Enable-PSBreakpoint включает точки останова.

Этот пример эквивалентен запуску Enable-PSBreakpoint -Id 3, 5.

Пример 5. Включение точки останова в пространстве выполнения

В этом примере задание запускается с точкой останова, которая устанавливается на прерывание, а затем отключается. Пространство выполнения сохраняется в переменной и передается команде Get-PSBreakPoint с параметром Runspace. Вывод Get-PSBreakPoint передается по конвейеру в Enable-PSBreakpoint, чтобы включить точку останова в пространстве выполнения.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Параметры

-Breakpoint

Указывает точки останова, которые необходимо включить. Укажите переменную, содержащую точки останова, или команду, которая получает объекты точек останова, например Get-PSBreakpoint. Вы также можете передать объекты точек останова в Enable-PSBreakpoint.

Тип :: Точка останова[]
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип :: SwitchParameter
Псевдонимы:: cf
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Id

Указывает номера Id точек останова, которые необходимо включить. Значение по умолчанию — все точки останова. Укажите Идентификатор по номеру или в переменной. Вы не можете передать номера Id в Enable-PSBreakpoint. Чтобы найти Идентификатор точки останова, используйте командлет Get-PSBreakpoint.

Тип :: Int32[]
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-PassThru

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

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Runspace

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

Этот параметр был добавлен в PowerShell 7.2.

Тип :: Пространство выполнения
Псевдонимы:: RunspaceId
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-WhatIf

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

Тип :: SwitchParameter
Псевдонимы:: wi
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Точка останова

Вы можете передать объект точки останова этому командлету.

Выходы

Нет

По умолчанию этот командлет не возвращает никаких результатов.

Точка останова

При использовании параметра PassThru этот командлет возвращает объект точки останова, представляющий включенную точку останова.

Примечания

PowerShell включает следующие псевдонимы для Enable-PSBreakpoint:

Все платформы:
Командлет Enable-PSBreakpoint не генерирует ошибку, если вы попытаетесь включить уже включенную точку останова. Таким образом, вы можете без ошибок включить все точки останова, даже если отключены лишь некоторые из них.
Точки останова включаются, когда вы создаете их с помощью командлета Set-PSBreakpoint. Вам не нужно включать вновь созданные точки останова.