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

Синтаксис

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

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

Описание

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

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

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

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

Параметры

-Breakpoint <Breakpoint[]>

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

Обязательно?	true
Позиция?	1
Значение по умолчанию	None.
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-Id <Int32[]>

Включает точки останова с указанными идентификаторами. По умолчанию используется значение "Все точки останова". Введите идентификаторы или переменную, которая их содержит. (Идентификаторы невозможно передать командлету Enable-PSBreakpoint по конвейеру.) Чтобы определить идентификатор точки останова, используйте командлет Get-PSBreakpoint.

Обязательно?	true
Позиция?	1
Значение по умолчанию	нет
Принимать входные данные из конвейера?	true (ByPropertyName)
Принимать подстановочные знаки?	false

-PassThru

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

Обязательно?	false
Позиция?	named
Значение по умолчанию	No output
Принимать входные данные из конвейера?	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

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

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

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

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

Примечания

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

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

Пример 1

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

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

Пример 2

C:\PS>enable-psbreakpoint -id 0, 1, 5

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

Пример 3

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

C:\PS> $b | disable-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

C:\PS> $b | enable-psbreakpoint -passthru

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 объект точки останова.

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

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

Результаты показаны в следующем примере выходных данных.

Пример 4

C:\PS>$b = get-psbreakpoint -id 3, 5

C:\PS> enable-psbreakpoint -breakpoint $b

Описание
-----------
Эти команды включают набор точек останова путем указания соответствующих объектов точек останова. 

Первая команда с помощью командлета Get-PSBreakpoint получает точки останова и сохраняет их в переменной $b. 

Вторая команда использует командлет Enable-PSBreakpoint с параметром Breakpoint, чтобы включить эти точки останова.
Эта команда эквивалентна команде "enable-psbreakpoint -id 3, 5".

Enable-PSBreakpoint