Поделиться через

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

Тип:Breakpoint[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

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

Тип:Int32[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Runspace

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

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

Тип:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Breakpoint[]

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

Int32[]

Runspace

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

None

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

Примечания

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

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