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