Get-PSBreakpoint

Ссылка

Модуль:: Microsoft.PowerShell.Utility

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

Синтаксис

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

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

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

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

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

Описание

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

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

Примеры

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

PS C:\> Get-PSBreakpoint

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

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

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

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

Пример 3. Передача идентификатора в командлет Get-PSBreakpoint по конвейеру

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint

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

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

Во второй команде используется оператор-точка (.) для получения свойства Id объекта точки останова в переменной $B. С помощью конвейерного оператора (|) идентификатор передается в командлет Get-PSBreakpoint.

В результате командлет Get-PSBreakpoint возвращает точку останова с указанным идентификатором.

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

PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

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

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

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

PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

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

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

PS C:\> Get-PSBreakpoint -Type Command -Script "Sample.ps1"

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

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

PS C:\> Get-PSBreakpoint -Variable "Index, Swap"

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

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

PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

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

Параметры

-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

-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

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

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

Идентификаторы и типы точек останова можно передавать в командлет Get-PSBreakpoint по конвейеру.

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

Breakpoint

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

Примечания

Вы можете использовать Get-PSBreakpoint или его псевдоним "гбит/с".