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

Disable-PSBreakpoint

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

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

Синтаксис

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

Описание

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

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

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

Примеры

Пример 1. Установка точки останова и его отключение

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Эти команды отключают только что созданную точку останова.

Первая команда использует командлет Set-PSBreakpoint для создания точки останова в переменной имени в скрипте Sample.ps1. Затем он сохраняет объект точки останова в переменной $B.

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

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

Пример 2. Отключение точки останова

PS C:\> Disable-PSBreakpoint -Id 0

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

Пример 3. Создание отключенной точки останова

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

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

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

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

Вторая команда отображает объект точки останова в значении переменной $B.

Пример 4. Отключение всех точек останова в текущей консоли

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

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

Параметры

-Breakpoint

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

Тип:Breakpoint[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Задает массив идентификаторов или переменных, содержащих идентификаторы точек останова. Не удается передать идентификаторы в Disable-PSBreakpoint.

Тип:Int32[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PassThru

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Breakpoint

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

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

None or System.Management.Automation.Breakpoint

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