Получает настроенные в текущем сеансе точки останова.
Синтаксис
Get-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>] Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>] Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>] Get-PSBreakpoint [-Type] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>] Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]
Описание
Командлет Get-PSBreakPoint получает настроенные в текущем сеансе точки останова. С помощью параметров командлета можно получать конкретные точки останова.
Точка останова — это точка в команде или скрипте, на которой выполнение временно останавливается, чтобы можно было проверить инструкции. Get-PSBreakpoint — это один из нескольких командлетов, предназначенных для отладки скриптов и команд Windows PowerShell. Дополнительные сведения об отладчике Windows PowerShell см. в разделе about_Debuggers.
Параметры
-Command <string[]>
Получает точки останова команд, для которых заданы имена. Введите имена команд, например имя командлета или функции.
Обязательно? |
true |
Позиция? |
named |
Значение по умолчанию |
All breakpoints |
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Id <Int32[]>
Получает точки останова с заданными идентификаторами. Введите идентификаторы, разделенные запятыми. Кроме того, можно передать идентификаторы точек останова командлету Get-PSBreakpoint по конвейеру.
Обязательно? |
true |
Позиция? |
1 |
Значение по умолчанию |
All breakpoints |
Принимать входные данные из конвейера? |
true (ByValue) |
Принимать подстановочные знаки? |
false |
-Script <string[]>
Получает только точки останова в заданных скриптах. Введите путь (необязательно) и имя одного или нескольких файлов скриптов. Местоположением по умолчанию является текущий каталог.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
All breakpoints |
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Type <BreakpointType[]>
Получает только точки останова заданных типов. Введите один или несколько типов. Допустимые значения: Line, Command и Variable. Кроме того, можно передать типы точек останова командлету Get-PSBreakpoint по конвейеру.
Обязательно? |
true |
Позиция? |
1 |
Значение по умолчанию |
All breakpoints |
Принимать входные данные из конвейера? |
true (ByValue) |
Принимать подстановочные знаки? |
false |
-Variable <string[]>
Получает точки останова переменных, для которых заданы имена. Введите имена переменных без знака доллара.
Обязательно? |
true |
Позиция? |
named |
Значение по умолчанию |
All breakpoints |
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
Входные данные |
System.Int32, Microsoft.PowerShell.Commands.BreakpointType Кроме того, можно передать идентификаторы и типы точек останова командлету Get-PSBreakpoint по конвейеру. |
Выходные данные |
Объект точки останова (System.Management.Automation.LineBreakpoint, System.Management.Automation.VariableBreakpoint, System.Management.Automation.CommandBreakpoint) Командлет Get-PSBreakPoint возвращает объекты, представляющие точки останова в этом разделе. |
Примечания
Можно использовать командлет Get-PSBreakpoint или его псевдоним "gbp".
Пример 1
C:\PS>get-psbreakpoint Описание ----------- Эта команда получает все точки останова, установленные во всех скриптах и функциях в текущем сеансе.
Пример 2
C:\PS>get-psbreakpoint -Id 2 Function : Increment Action : Enabled : True HitCount : 0 Id : 2 Script : C:\ps-test\sample.ps1 ScriptName : C:\ps-test\sample.ps1 Описание ----------- Эта команда получает точку останова с идентификатором 2.
Пример 3
C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment C:\PS> $b.Id | get-psbreakpoint Описание ----------- Эти команды показывают, как получить точку останова путем передачи идентификатора точки останова командлету Get-PSBreakpoint по конвейеру. Первая команда использует командлет Set-PSBreakpoint, чтобы создать точку останова на функции Increment в скрипте Sample.ps1. Она сохраняет объект точки останова в переменной $b. Вторая команда с помощью оператора точки (.) получает свойство Id объекта точки останова в переменной $b. Идентификатор передается командлету Get-PSBreakpoint с помощью оператора конвейера (|). В результате командлет Get-PSBreakpoint получает точку останова с заданным идентификатором.
Пример 4
C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1 Описание ----------- Эта команда получает все точки останова в файлах Sample.ps1 и SupportScript.ps1. Эта команда не получает другие точки останова, которые могут быть установлены в других скриптах или функциях в данном сеансе.
Пример 5
C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1 Описание ----------- Эта команда получает все точки останова команд, установленные на командах Read-Host и Write-Host в файле Sample.ps1.
Пример 6
C:\PS>get-psbreakpoint -type Command -script Sample.ps1 Описание ----------- Эта команда получает все точки останова команд, установленные в файле Sample.ps1.
Пример 7
C:\PS>get-psbreakpoint -variable Index, Swap Описание ----------- Эта команда получает все точки останова, установленные на переменных $index и $swap в текущем сеансе.
Пример 8
C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1 Описание ----------- Эта команда получает все точки останова строк и переменных в скрипте Sample.ps1.
См. также