Get-PSBreakpoint

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Runspace <Runspace>]
    [<CommonParameters>]

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Command <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Variable <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Type] <BreakpointType[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Get-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

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

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

Эта команда получает все точки останова, заданные для всех скриптов и функций в текущем сеансе.

Get-PSBreakpoint

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

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Эти команды показывают, как получить точку останова путем передачи идентификатора точки останова в Get-PSBreakpoint.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Командлет Set-PSBreakpoint создает точку останова для функции Increment в скрипте Sample.ps1 и сохраняет объект точки останова в переменной $B. Свойство Id объекта точки останова в переменной $B будет передано командлету Get-PSBreakpoint для отображения сведений о точке останова.

Эта команда получает все точки останова в файлах Sample.ps1 и SupportScript.ps1.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Эта команда не получает другие точки останова, которые могут быть заданы в других сценариях или функциях в сеансе.

Эта команда получает все точки останова команд, заданные в командах Read-Host или Write-Host в файле Sample.ps1.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Эта команда получает все точки останова команды (Command breakpoints) в файле Sample.ps1.

Эта команда получает точки останова, заданные в переменных $Index и $Swap в текущем сеансе.

Get-PSBreakpoint -Variable "Index, Swap"

Эта команда получает все точки останова строк и переменных в скрипте Sample.ps1.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

В этом примере задание запускается, а точка останова устанавливается для разрыва при запуске Set-PSBreakpoint. Пространство выполнения хранится в переменной и передается команде Get-PSBreakpoint с параметром Runspace. Затем можно проверить точку останова в переменной $breakpoint.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakpoint -Runspace $runspace

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

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

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

PowerShell включает следующие псевдонимы для Get-PSBreakpoint:

• Все платформы:
  • gbp