Get-PSBreakpoint
Obtém os pontos de interrupção definidos na sessão atual.
Sintaxe
Script (Predefinição)
Get-PSBreakpoint
[[-Script] <String[]>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[<CommonParameters>]
Command
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[<CommonParameters>]
Variable
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[<CommonParameters>]
Id
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 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 para 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
Este 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
Este comando obtém o ponto de interrupção com ID de ponto de interrupção 2.
Exemplo 3: Canalizar um ID para Get-PSBreakpoint
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint
Estes comandos mostram como obter um ponto de interrupção canalizando um 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 dot (.) 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"
Este comando obtém todos os pontos de interrupção nos arquivos Sample.ps1 e SupportScript.ps1.
Este 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"
Este 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"
Este 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"
Este 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"
Este comando obtém todos os pontos de interrupção de linha e variáveis 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 dos comandos, como o nome de um cmdlet ou função.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Command
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Especifica as IDs de ponto de interrupção que esse cmdlet obtém. Insira os IDs em uma lista separada por vírgula. Você também pode canalizar IDs de ponto de interrupção para Get-PSBreakpoint.
Propriedades dos parâmetros
| Tipo: | Int32[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Id
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Script
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
Type
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
Command
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
Variable
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | BreakpointType[] |
| Default value: | None |
| Valores aceites: | Line, Variable, Command |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Type
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Variable
Especifica uma matriz de pontos de interrupção de variáveis que são definidos nos nomes de variáveis especificados. Insira os nomes das variáveis sem cifrões.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Variable
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
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.
Notas
- Você pode usar Get-PSBreakpoint ou seu alias, "gbp".