Отключает точки останова для текущей консоли.
Синтаксис
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".
См. также