Enable-PSBreakpoint

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

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

Синтаксис

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

Описание

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

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

Технически этот командлет изменяет значение свойства Enabled объекта точки останова на True.

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

Примеры

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

Этот пример включает все точки останова в текущем сеансе.

Get-PSBreakpoint | Enable-PSBreakpoint

С помощью псевдонимов этот пример может быть сокращен как gbp | ebp.

Пример 2. Включение точек останова по идентификатору

В этом примере можно включить несколько точек останова с помощью идентификаторов точек останова.

Enable-PSBreakpoint -Id 0, 1, 5

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

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

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint создает точку останова для переменной Name в скрипте Sample.ps1 , сохраняя объект точки останова в переменной $B . Параметр PassThru отображает значение свойства Enabled точки останова false.

Enable-PSBreakpoint повторно включает точку останова. Опять же, используя параметр PassThru , мы видим, что значение свойства Enabled равно True.

Пример 4. Включение точек останова с помощью переменной

В этом примере включается набор точек останова с помощью объектов точек останова.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint возвращает точки останова и сохраняет их в переменной $B . Использование параметра Enable-PSBreakpointточки останова включает точки останова.

Этот пример эквивалентен выполнению Enable-PSBreakpoint -Id 3, 5.

Параметры

-Breakpoint

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

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Указывает идентификаторы точек останова, которые необходимо включить. Значение по умолчанию — все точки останова. Укажите идентификатор по числу или в переменной. Не удается передать в нее Enable-PSBreakpointномера идентификаторов. Чтобы найти идентификатор точки останова, используйте Get-PSBreakpoint командлет.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Breakpoint

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

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

None or System.Management.Automation.Breakpoint

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

Примечания

  • Командлет Enable-PSBreakpoint не создает ошибку, если вы попытаетесь включить точку останова, которая уже включена. Таким образом, можно включить все точки останова, не опасаясь ошибок, даже если только некоторые из них отключены.

  • Точки останова включаются при их создании с помощью командлета Set-PSBreakpoint . Вам не нужно включать только что созданные точки останова.