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

Синтаксис

Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

Командлет Disable-PSBreakpoint отключает точки останова, что означает, что они не будут использоваться при выполнении скрипта. С помощью этого командлета можно отключить все точки останова или указать конкретные точки, задав объекты точек останова или их идентификаторы.

Технически этот командлет изменяет значение свойства Enabled объекта точки останова на False. Чтобы заново включить точку останова, следует использовать командлет Enable-PSBreakpoint. Точки останова по умолчанию включаются при их создании с помощью командлета Set-PSBreakpoint.

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

Параметры

-Breakpoint <Breakpoint[]>

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

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

true

Позиция?

1

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

нет

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

true (ByValue)

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

false

-Id <Int32[]>

Отключает точки останова с указанными идентификаторами. Введите идентификаторы или переменную, которая их содержит. Идентификаторы невозможно передать командлету Disable-PSBreakpoint по конвейеру.

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

true

Позиция?

1

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

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

true (ByPropertyName)

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

false

-PassThru

Возвращает объект, представляющий включенные точки останова. По умолчанию этот командлет не формирует никаких выходных данных.

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

false

Позиция?

named

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

нет

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

false

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

false

-Confirm

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

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

false

Позиция?

named

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

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

false

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

false

-WhatIf

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

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

false

Позиция?

named

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

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

false

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

false

<CommonParameters>

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

Ввод и вывод

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

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

System.Management.Automation.Breakpoint

Объект точки останова можно передать командлету Disable-PSBreakpoint по конвейеру.

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

Нет или System.Management.Automation.Breakpoint

При использовании параметра PassThru командлет Disable-PSBreakpoint возвращает объект, представляющий отключенную точку останова. В противном случае этот командлет не формирует никаких выходных данных.

Пример 1

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

C:\PS> $b | disable-psbreakpoint

Описание
-----------
Эти команды отключают созданную перед этим точку останова. 

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

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

В результате выполнения этой команды свойство Enabled объекта точки останова в переменной $b принимает значение False.






Пример 2

C:\PS>disable-psbreakpoint -id 0

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






Пример 3

C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) 

C:\PS> $b

Описание
-----------
Эта команда создает новую точку останова, которая будет оставаться отключенной, пока пользователь не включит ее.

Чтобы отключить точку останова, она использует командлет Disable-PSBreakpoint. Значением параметра Breakpoint является команда Set-PSBreakpoint, которая устанавливает новую точку останова, создает объект точки останова и сохраняет объект в переменной $b. 

Параметры командлета, принимающие в качестве значений объекты, могут принять также и переменную, которая содержит объект, или команду, которая получает или создает объект. В данном случае, поскольку командлет Set-PSBreakpoint создает объект точки останова, его можно использовать в качестве значения параметра Breakpoint.

Вторая команда выводит объект точки останова, хранящийся в переменной $b.






Пример 4

C:\PS>get-psbreakpoint | disable-psbreakpoint

Описание
-----------
Эта команда отключает все точки останова для текущей консоли. Эту команду можно сократить следующим образом: "gbp | dbp".






См. также




Содержание