Partilhar via

Get-PSBreakpoint

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Obtém os pontos de interrupção definidos na sessão atual.

Sintaxe

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>]

Description

O Get-PSBreakPoint cmdlet obtém os pontos de interrupção definidos na sessão atual. Você pode usar os parâmetros do cmdlet para obter pontos de interrupção específicos.

Um ponto de interrupção é um ponto em um comando ou script onde a execução para temporariamente para que você possa examinar as instruções. Get-PSBreakpoint é um dos vários cmdlets projetados para depurar scripts e comandos do PowerShell. Para obter mais informações sobre o depurador do PowerShell, consulte about_Debuggers.

Exemplos

Exemplo 1: Obter todos os pontos de interrupção para todos os scripts e funções

Este comando obtém todos os pontos de interrupção definidos em todos os scripts e funções na sessão atual.

Get-PSBreakpoint

Exemplo 2: Obter pontos de interrupção por ID

Este comando obtém o ponto de interrupção com ID de ponto de interrupção 2.

Get-PSBreakpoint -Id 2

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

Exemplo 3: Canalizar um ID para 'Get-PSBreakpoint'

Estes comandos mostram como obter um ponto de interrupção canalizando um ID de ponto de interrupção para Get-PSBreakpoint.

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

O Set-PSBreakpoint cmdlet cria um ponto de interrupção na função Increment no Sample.ps1 script e salva o objeto de ponto de interrupção na $B variável. A propriedade Id do objeto de ponto de interrupção na $B variável é canalizada para o Get-PSBreakpoint cmdlet para exibir as informações do ponto de interrupção.

Exemplo 4: Obter pontos de interrupção em arquivos de script especificados

Este comando obtém todos os pontos de interrupção nos Sample.ps1 arquivos e SupportScript.ps1 .

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

Este comando não obtém outros pontos de interrupção que podem ser definidos em outros scripts ou em funções na sessão.

Exemplo 5: Obter pontos de interrupção em cmdlets especificados

Este comando obtém todos os pontos de interrupção de comando que estão definidos Read-Host ou Write-Host comandos no Sample.ps1 arquivo.

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

Exemplo 6: Obter pontos de interrupção de comando em um arquivo especificado

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

Este comando obtém todos os pontos de interrupção de comando no arquivo Sample.ps1.

Exemplo 7: Obter pontos de interrupção por variável

Este comando obtém pontos de interrupção definidos nas $Index variáveis e $Swap na sessão atual.

Get-PSBreakpoint -Variable "Index, Swap"

Exemplo 8: Obter todos os pontos de interrupção de linha e variável em um arquivo

Este comando obtém todos os pontos de interrupção de linha e variáveis no Sample.ps1 script.

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

Exemplo 9: Obter os pontos de interrupção definidos em um espaço de execução específico

Neste exemplo, um trabalho é iniciado e um ponto de interrupção é definido para quebrar quando o Set-PSBreakPoint é executado. O runspace é armazenado em uma variável e passado para o Get-PSBreakPoint comando com o parâmetro Runspace . Em seguida, você pode inspecionar o ponto de interrupção na $breakpoint variável.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Parâmetros

-Command

Especifica uma matriz de pontos de interrupção de comando que são definidos nos nomes de comando especificados. Insira os nomes dos comandos, como o nome de um cmdlet ou função.

Tipo:String[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

Especifica as IDs de ponto de interrupção que esse cmdlet obtém. Insira os IDs em uma lista separada por vírgula. Você também pode canalizar IDs de ponto de interrupção para Get-PSBreakpoint.

Tipo:Int32[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Runspace

Especifica a Id de um objeto Runspace para que você possa interagir com pontos de interrupção no espaço de execução especificado.

Esse parâmetro foi adicionado no PowerShell 7.2.

Tipo:Runspace
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Script

Especifica uma matriz de scripts que contêm os pontos de interrupção. Insira o caminho (opcional) e os nomes de um ou mais arquivos de script. Se você omitir o caminho, o local padrão será o diretório atual.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Type

Especifica uma matriz de tipos de ponto de interrupção que esse cmdlet obtém. Insira um ou mais tipos. Os valores aceitáveis para este parâmetro são:

  • Line
  • Comando
  • Variável

Você também pode canalizar tipos de ponto de interrupção para Get-PSBreakPoint.

Tipo:BreakpointType[]
Valores aceites:Line, Variable, Command
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Variable

Especifica uma matriz de pontos de interrupção de variáveis que são definidos nos nomes de variáveis especificados. Insira os nomes das variáveis sem cifrões.

Tipo:String[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

Int32

Você pode canalizar IDs de ponto de interrupção para este cmdlet.

BreakpointType

Você pode canalizar tipos de ponto de interrupção para este cmdlet.

Saídas

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Este cmdlet retorna objetos que representam os pontos de interrupção na sessão.

Notas

O PowerShell inclui os seguintes aliases para Get-PSBreakpoint:

  • Todas as plataformas:
    • gbp