Remove-PSBreakpoint

Статья
10/30/2009

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

Синтаксис

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.

См. также

Концепции

about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Disable-PSBreakpoint
Get-PSCallStack

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