Get-PSBreakpoint
Obtém os pontos de interrupção definidos na sessão atual.
Sintaxe
Line (Default)
Get-PSBreakpoint
[[-Script] <String[]>]
[-Runspace <Runspace>]
[<CommonParameters>]
Command
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Variable
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Id
Get-PSBreakpoint
[-Id] <Int32[]>
[-Runspace <Runspace>]
[<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 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
Esse 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
Esse comando obtém o ponto de interrupção com a ID do 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: redirecionar 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 cmdlet Set-PSBreakpoint cria um ponto de interrupção na função Increment no script Sample.ps1 e salva o objeto de ponto de interrupção na variável $B. A propriedade ID do objeto de ponto de interrupção na variável $B é canalizada para o cmdlet Get-PSBreakpoint 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 Sample.ps1 e SupportScript.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 comandos Read-Host ou Write-Host no arquivo Sample.ps1.
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"
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
Esse comando obtém pontos de interrupção definidos nas variáveis $Index 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 script Sample.ps1.
Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Exemplo 9: Obter os pontos de interrupção definidos em um runspace específico
Neste exemplo, um trabalho é iniciado e um ponto de interrupção é definido para ser interrompido quando o Set-PSBreakPoint é executado. O runspace é armazenado em uma variável e passado 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 o nome de um cmdlet ou função.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Command
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 canalizar IDs do ponto de interrupção para Get-PSBreakpoint.
Propriedades do parâmetro
| Tipo: | Int32[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Id
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Runspace
Especifica a ID de um runspace objeto para que você possa interagir com pontos de interrupção no runspace especificado.
Esse parâmetro foi adicionado ao PowerShell 7.2.
Propriedades do parâmetro
| Tipo: | Runspace |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Script
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Variable
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Command
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Type
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | |
| Valor padrão: | None |
| Valores aceitos: | Line, Variable, Command |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Type
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Variable
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
Int32
Você pode redirecionar IDs de ponto de interrupção para este cmdlet.
BreakpointType
Você pode redirecionar tipos de ponto de interrupção para este 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