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останова также можно передать в .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Runspace

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

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

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Breakpoint[]

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

Int32[]

Runspace

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

None

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

Примечания

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

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