Disable-PSBreakpoint (Microsoft.PowerShell.Utility)

Отключить-PSBreakpoint

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

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

Синтаксис

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 отключает новую точку останова. Он использует оператор конвейера (|) для отправки объекта точки останова в $B командлету Disable-PSBreakpoint.

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

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

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

Disable-PSBreakpoint -Id 0

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

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

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

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

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

Пример 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

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

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

-Confirm

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

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

-Id

Отключает точки останова с указанными идентификаторами точек останова. Введите идентификаторы или переменную, содержащую эти идентификаторы. Вы не можете передать идентификаторы в Disable-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 включает следующие псевдонимы для Disable-PSBreakpoint:

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