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

Remove-PSBreakpoint

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

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

Синтаксис

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

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

Id 

Remove-PSBreakpoint
    [-Id] <Int32[]>
    [-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, который удаляет их.

Параметры

-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

-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

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

Примечания

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

  • rbp