Disable-PSBreakpoint

Синтаксис

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

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

Описание

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

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

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

Примеры

Пример 1. Установка точки останова и его отключение

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

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

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

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

Пример 2. Отключение точки останова

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

Disable-PSBreakpoint -Id 0

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

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

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

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

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

Пример 4. Отключение всех точек останова в текущей консоли

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

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

В этом примере задание запускается с точкой останова, для которой настроена прерывание при выполнении 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

Параметры

-Breakpoint

-Confirm

-Id

-PassThru

-Runspace

-WhatIf

Входные данные

Breakpoint

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

Выходные данные

None

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

Breakpoint

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

Примечания

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

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

Связанные ссылки

• Enable-PSBreakpoint
• Get-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint