Поделиться через

Get-PSBreakpoint

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

Возвращает точки останова, установленные в рамках текущего сеанса.

Синтаксис

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.

Примеры

Пример 1. Получение всех точек останова для всех скриптов и функций

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

Get-PSBreakpoint

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

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

Get-PSBreakpoint -Id 2

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

Пример 3. Конвейер идентификатора в Get-PSBreakpoint

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

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

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

Пример 4. Возвращение точек останова в указанных файлах скриптов

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

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

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

Пример 5. Возвращение точек останова в указанных командлетах

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

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

Пример 6. Возвращение точек останова команды в указанном файле

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

Эта команда возвращает все точки останова команд в файле Sample.ps1.

Пример 7. Получение точек останова по переменной

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

Get-PSBreakpoint -Variable "Index, Swap"

Пример 8. Возвращение всех точек останова строк и переменных в файле

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

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

Пример 9. Получение точек останова, заданных в определенном пространстве выполнения

В этом примере задание запускается с точкой останова, для которой настроена прерывание при выполнении 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

Параметры

-Command

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Id

Указывает идентификаторы точки останова, которую возвращает этот командлет. Введите идентификаторы в виде разделенного запятыми списка. Вы также можете передать идентификаторы точек останова в Get-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Runspace

Задает идентификатор объекта Runspace , чтобы можно было взаимодействовать с точками останова в указанном пространстве выполнения.

Этот параметр был добавлен в PowerShell 7.2.

Type:Runspace
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Указывает массив скриптов, содержащих точки останова. Введите путь (необязательно) и имена одного или нескольких файлов скриптов. Если путь не указан, расположением по умолчанию является текущий каталог.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Type

Указывает массив типов точек останова, которые возвращает этот командлет. Введите один или несколько типов. Допустимые значения для этого параметра:

  • График
  • Get-Help
  • Переменная

Типы точек останова также можно передать в Get-PSBreakPoint.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Variable

Указывает массив точек останова, заданных для переменных с указанными именами. Введите имена переменных без знака доллара.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

Int32

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

BreakpointType

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

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

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

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

Примечания

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

  • Для всех платформ.
    • gbp