Disable-PSBreakpoint

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

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

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

Технически этот командлет изменяет значение свойства Enabled объекта точки останова на False. Чтобы повторно включить точку останова, используйте командлет Enable-PSBreakpoint. Точки останова включены по умолчанию при создании с помощью командлета Set-PSBreakpoint.

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

Эти команды отключают только что созданную точку останова.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Командлет Set-PSBreakpoint создает точку останова в переменной $Name в скрипте Sample.ps1 и сохраняет объект точки останова в переменной $B. Командлет Disable-PSBreakpoint отключает новую точку останова. Он использует оператор конвейера (|) для отправки объекта точки останова в $B командлету Disable-PSBreakpoint.

В результате этой команды значение свойства Enabled объекта точки останова в $B равно False.

Эта команда отключает точку останова с идентификатором точки останова 0.

Disable-PSBreakpoint -Id 0

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

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Он использует командлет Disable-PSBreakpoint для отключения точки останова. Значение параметра точки останова — это команда Set-PSBreakpoint, которая задает новую точку останова, создает объект точки останова и сохраняет объект в переменной $B.

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

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

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

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

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

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

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

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

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

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