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

Синтаксис

Remove-PSBreakpoint [-Id] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>]

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

Описание

Командлет Remove-PSBreakpoint удаляет точку останова. Введите объект или идентификатор точки останова.

При удалении точки останова объект точки останова становится недоступным и перестает функционировать. Если объект точки останова был сохранен в переменной, ссылка сохранится, но точка останова не будет работать.

Remove-PSBreakpoint — это один из нескольких командлетов, предназначенных для отладки скриптов Windows PowerShell. Дополнительные сведения об отладчике Windows PowerShell см. в разделе about_Debuggers.

Параметры

-Breakpoint <Breakpoint[]>

Задает точки останова для удаления. Введите переменную, содержащую объекты точек останова, либо команду, получающую объекты точек останова, например Get-PSBreakpoint. Кроме того, можно передать объекты точек останова командлету Remove-PSBreakpoint по конвейеру.

Обязательно?

true

Позиция?

1

Значение по умолчанию

нет

Принимать входные данные из конвейера?

true (ByValue)

Принимать подстановочные знаки?

false

-Id <Int32[]>

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

Обязательно?

true

Позиция?

1

Значение по умолчанию

нет

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Confirm

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

System.Management.Automation.Breakpoint

Кроме того, можно передать объекты точек останова командлету Remove-PSBreakpoint по конвейеру.

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

Нет

Командлет не формирует никаких выходных данных.

Пример 1

C:\PS>get-breakpoint | remove-breakpoint

Описание
-----------
Эта команда удаляет все точки останова в текущей консоли.






Пример 2

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | remove-psbreakpoint

Описание
-----------
Эта команда удаляет точку останова.

Первая команда использует командлет Set-PSBreakpoint, чтобы создать точку останова на переменной Name в скрипте Sample.ps1. После этого она сохраняет в переменной $b объект точки останова.

Вторая команда использует командлет Remove-PSBreakpoint, чтобы удалить эту новую точку останова. С помощью оператора конвейера (|) она передает объект точки останова в переменной $b командлету Remove-PSBreakpoint.

В результате выполнения этой команды при запуске скрипта он будет выполнен до конца без остановки. Кроме того, командлет Get-PSBreakpoint не будет возвращать эту точку останова.






Пример 3

C:\PS>remove-psbreakpoint -id 2

Описание
-----------
Эта команда удаляет точку останова с идентификатором 2.






Пример 4

C:\PS>function del-psb { get-psbreakpoint | remove-psbreakpoint }

Описание
-----------
Эта простая функция удаляет все точки останова в текущей консоли. С помощью командлета Get-PSBreakpoint она получает точки останова. Затем с помощью оператора конвейера (|) она передает точки останова командлету Remove-PSBreakpoint, который удаляет их. 

В результате вместо более длинной команды пользователь вводит "del-psb".

Чтобы сохранить эту функцию, ее следует добавить в профиль Windows PowerShell.






См. также