Compartilhar via


Get-PSBreakpoint

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

Sintaxe

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

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

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

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

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

Descrição

O cmdlet Get-PSBreakPoint obtém os pontos de interrupção que sã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 em um comando ou script é o ponto onde a execução para temporariamente para que você possa examinar as instruções. Get-PSBreakpoint é um dos vários cmdlets criados para depuração de scripts e comandos do Windows PowerShell. Para obter mais informações sobre o depurador do Windows PowerShell, consulte about_Debuggers.

Parâmetros

-Command <string[]>

Obtém pontos de interrupção de comando que são definidos nos nomes de comando especificados. Digite os nomes de comando, como o nome de um cmdlet ou função.

Necessário?

true

Posição?

named

Valor padrão

Todos os pontos de interrupção

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Id <Int32[]>

Obtém os pontos de interrupção com as IDs de ponto de interrupção especificadas. Digite as IDs em uma lista separada por vírgula. Também é possível enviar IDs de ponto de interrupção para Get-PSBreakpoint.

Necessário?

true

Posição?

1

Valor padrão

Todos os pontos de interrupção

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

-Script <string[]>

Obtém apenas os pontos de interrupção nos scripts especificados. Digite o caminho (opcional) e os nomes de um ou mais arquivos de script. O local padrão é o diretório atual.

Necessário?

false

Posição?

named

Valor padrão

Todos os pontos de interrupção

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Type <BreakpointType[]>

Obtém apenas os tipos especificados de pontos de interrupção. Digite um ou mais tipos. Os valores válidos são Line, Command e Variable. Também é possível enviar tipos de pontos de interrupção para Get-PSBreakpoint.

Necessário?

true

Posição?

1

Valor padrão

Todos os pontos de interrupção

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

-Variable <string[]>

Obtém pontos de interrupção de variável que são definidos nos nomes de variável especificados. Digite os nomes de variáveis sem o cifrão.

Necessário?

true

Posição?

named

Valor padrão

Todos os pontos de interrupção

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

Também é possível enviar IDs e tipos de pontos de interrupção para Get-PSBreakpoint.

Saídas

Objeto de ponto de interrupção (System.Management.Automation.LineBreakpoint, System.Management.Automation.VariableBreakpoint, System.Management.Automation.CommandBreakpoint)

Get-PSBreakPoint retorna objetos que representam os pontos de interrupção da sessão.

Observações

Você pode utilizar Get-PSBreakpoint ou seu alias, "gbp".

Exemplo 1

C:\PS>get-psbreakpoint

Descrição
-----------
Este comando obtém todo o conjunto de pontos de interrupção em todos os scripts e funções da sessão atual.





Exemplo 2

C:\PS>get-psbreakpoint -Id 2

Function   : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 2
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Descrição
-----------
Esse comando obtém o ponto de interrupção com ID de ponto de interrupção 2.





Exemplo 3

C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment

C:\PS> $b.Id | get-psbreakpoint

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

O primeiro comando usa o cmdlet Set-PSBreakpoint para criar um ponto de interrupção na função Increment no script Sample.ps1. Ele salva o objeto de ponto de interrupção na variável $b.

O segundo comando usa o operador ponto (.) para obter a propriedade de identificação do objeto de ponto de interrupção na variável $b. Ele usa um operador de pipeline (|) para enviar a ID para o cmdlet Get-PSBreakpoint.

Como resultado, Get-PSBreakpoint obtém o ponto de interrupção com a ID especificada.





Exemplo 4

C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1

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

Esse comando não obtém outros pontos de interrupção que poderiam ser definidos em outros scripts ou em funções da sessão.





Exemplo 5

C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1

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





Exemplo 6

C:\PS>get-psbreakpoint -type Command -script Sample.ps1

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





Exemplo 7

C:\PS>get-psbreakpoint -variable Index, Swap

Descrição
-----------
Este comando obtém pontos de interrupção que são definidos nas variáveis $index e $swap na sessão atual.





Exemplo 8

C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1

Descrição
-----------
Este comando define todos os pontos de interrupção de linha e variável no script Sample.ps1.





Consulte também

Conceitos

about_Debuggers
Set-PSBreakpoint
Disable-PSBreakpoint
Enable-PSBreakpoint
Remove-PSBreakpoint
Get-PSCallStack