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

Remove-PSBreakpoint

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

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

Синтаксис

Breakpoint (по умолчанию) 

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

Id 

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[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Breakpoint
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Id

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

Свойства параметра

Тип:

Int32[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Id
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Runspace

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

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

Свойства параметра

Тип:Runspace
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:RunspaceId

Наборы параметров

Id
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

Breakpoint

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

Int32

Runspace

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

None

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

Примечания

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

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