Get-PSBreakpoint (Microsoft.PowerShell.Utility)

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-Host или Write-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

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

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Id

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

Тип :: Int32[]
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Runspace

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

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

Тип :: Пространство выполнения
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Script

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

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Type

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

Линия
Команда
Переменная

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

Тип :: Тип точки останова[]
Принятые значения:: Линия, Переменная, Команда
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Variable

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

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Int32

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

Тип точки останова

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

Выходы

CommandBreakpoint

Точка разрыва строки

Переменная точка останова

Точка останова

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

Примечания

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

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