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[]>]
   [-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 é interrompida 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 presentes na sessão atual.

Get-PSBreakpoint

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

Esse comando obtém o ponto de interrupção com o identificador 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 uma ID para 'Get-PSBreakpoint'

Esses comandos mostram como obter um ponto de interrupção canalizando uma 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 $B objeto de ponto de interrupção na 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

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

Get-PSBreakpoint -Script "Sample.ps1, 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

Esse comando obtém todos os pontos de interrupção de comando definidos em 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 do comando contidos no arquivo Sample.ps1.

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

Esse 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

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

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

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

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

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 de comando, como, por exemplo, 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. Digite os identificadores em uma lista separada por vírgulas. Você também pode canalizar 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

-Runspace

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

Esse parâmetro foi adicionado no PowerShell 7.2.

Tipo:Runspace
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 a considerar é o diretório atual.

Tipo:String[]
Cargo:Named
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 esse 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 de variáveis que são definidas nos nomes de variáveis especificados. Digite os nomes de variáveis sem cifrões.

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

Entradas

Int32

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

BreakpointType

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

Saídas

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

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

Observações

O PowerShell inclui os seguintes aliases para Get-PSBreakpoint:

  • Todas as plataformas:
    • gbp