Remove-PSBreakpoint
Удаляет из текущей консоли точки останова.
Синтаксис
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 |
Входные данные
Объекты точек останова можно передать в этот командлет по конвейеру.
Int32[]
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
PowerShell включает следующие псевдонимы для Remove-PSBreakpoint
:
- Для всех платформ.
rbp