Remove-PSBreakpoint (Microsoft.PowerShell.Utility)

Удалить-PSBreakpoint

Модуль:

Microsoft.PowerShell.Utility

Удаляет точки останова из текущей консоли.

Синтаксис

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

Описание

Командлет Remove-PSBreakpoint удаляет точку останова. Введите объект точки останова или идентификатор точки останова.

Когда вы удаляете точку останова, объект точки останова больше не доступен и не функционирует. Если вы сохранили объект точки останова в переменной, ссылка все еще существует, но точка останова не работает.

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

Примеры

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

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

Get-PSBreakpoint | Remove-PSBreakpoint

Пример 2. Удаление указанной точки останова

Эта команда удаляет точку останова.

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

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

В результате выполнения этой команды, если вы запустите сценарий, он завершится без остановки. Кроме того, командлет Get-PSBreakpoint не возвращает эту точку останова.

Пример 3. Удаление точки останова по идентификатору

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

Remove-PSBreakpoint -Id 2

Пример 4. Используйте функцию для удаления всех точек останова.

Эта простая функция удаляет все точки останова в текущем сеансе.

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

Для получения точек останова он использует командлет Get-PSBreakpoint. Затем он использует оператор конвейера (|) для отправки точек останова командлету Remove-PSBreakpoint, который удаляет их.

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

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

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

$runspace = Get-Runspace -Id 1

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

Параметры

-Breakpoint

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

Тип :

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

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Confirm

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

Тип :

SwitchParameter

Псевдонимы:

cf

Позиция:

Именованный

Значение по умолчанию:

False

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Id

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

Тип :

Int32[]

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Runspace

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

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

Тип :

Пространство выполнения

Псевдонимы:

RunspaceId

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-WhatIf

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

Тип :

SwitchParameter

Псевдонимы:

wi

Позиция:

Именованный

Значение по умолчанию:

False

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

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

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

Int32[]

Пространство выполнения

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

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

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

  rbp