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