Get-PSBreakpoint
Возвращает точки останова, установленные в рамках текущего сеанса.
Синтаксис
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 по конвейеру.
Выходные данные
Командлет Get-PSBreakpoint возвращает объекты, которые представляют точки останова в рамках сеанса.
Примечания
- Вы можете использовать Get-PSBreakpoint или его псевдоним "гбит/с".