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

Get-PSBreakpoint

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

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

Синтаксис

Get-PSBreakpoint
   [[-Script] <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   -Command <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   -Variable <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Type] <BreakpointType[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <int[]>
   [<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"

Параметры

-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

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

Int32

BreakpointType

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

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

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

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

Примечания

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