Получает настроенные в текущем сеансе точки останова.

Синтаксис

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.






См. также