Compartilhar 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[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

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

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

Exemplos

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

PS C:\> Get-PSBreakpoint

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

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

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

Esse comando obtém o ponto de interrupção com a ID do ponto de interrupção 2.

Exemplo 3: redirecionar uma ID para Get-PSBreakpoint

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint

Esses comandos mostram como obter um ponto de interrupção canalizando 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 de ponto (.) para obter a propriedade ID 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: Obter pontos de interrupção em arquivos de script especificados

PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

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

Esse 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

PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

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

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

PS C:\> Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Esse 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

PS C:\> Get-PSBreakpoint -Variable "Index, Swap"

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

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

PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

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

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 de comando, como o nome de um cmdlet ou função.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

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

Tipo:Int32[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Script

Especifica uma matriz de scripts que contêm os pontos de interrupção. Insira o caminho 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[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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:

  • Linha
  • Comando
  • Variável

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

Tipo:BreakpointType[]
Valores aceitos:Line, Variable, Command
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Variable

Especifica uma matriz de pontos de interrupção variáveis que são definidos nos nomes de variáveis especificados. Insira os nomes de variáveis sem sinais de dólar.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

Você pode canalizar IDs de ponto de interrupção e tipos de ponto de interrupção para Get-PSBreakPoint.

Saídas

Breakpoint

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

Observações

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