Enable-PSBreakpoint

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

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

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

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

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

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

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

Get-PSBreakpoint | Enable-PSBreakpoint

С помощью псевдонимов этот пример может быть сокращен как gbp | ebp.

В этом примере можно включить несколько точек останова с помощью идентификаторов точек останова.

Enable-PSBreakpoint -Id 0, 1, 5

Этот пример повторно включает точку останова, которая была отключена.

$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.

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

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

Get-PSBreakpoint получает точки останова и сохраняет их в переменной $B. С помощью параметра точки останова включает точки останова.

Этот пример эквивалентен выполнению Enable-PSBreakpoint -Id 3, 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

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

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

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

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

• Все платформы:

  • ebp

• Командлет Enable-PSBreakpoint не создает ошибку, если вы пытаетесь включить точку останова, которая уже включена. Таким образом, можно включить все точки останова без ошибок, даже если только несколько отключены.

• Точки останова включены при создании с помощью командлета Set-PSBreakpoint. Вам не нужно включать только что созданные точки останова.