Get-PSBreakpoint
Obtém os pontos de interrupção definidos na sessão atual.
Syntax
Get-PSBreakpoint
[-Script <String[]>]
[<CommonParameters>]
Get-PSBreakpoint
[-Script <String[]>]
-Variable <String[]>
[<CommonParameters>]
Get-PSBreakpoint
[-Script <String[]>]
-Command <String[]>
[<CommonParameters>]
Get-PSBreakpoint
[-Script <String[]>]
[-Type] <BreakpointType[]>
[<CommonParameters>]
Get-PSBreakpoint
[-Id] <Int32[]>
[<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 objeto de ponto de interrupção na $B
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 de 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 Sample.ps1
arquivos 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 ou Read-Host
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 Sample.ps1
linha e variáveis no script.
Get-PSBreakpoint -Type Line, Variable -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, por exemplo, o nome de um cmdlet ou função.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | BreakpointType[] |
Accepted values: | Line, Variable, Command |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Variable
Especifica uma matriz de pontos de interrupção de variáveis que são definidos nos nomes de variáveis especificados. Digite os nomes de variáveis sem cifrões.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode canalizar IDs de ponto de interrupção para esse cmdlet.
Você pode canalizar tipos de ponto de interrupção para esse cmdlet.
Saídas
Esse cmdlet retorna objetos que representam os pontos de interrupção na sessão.
Observações
O Windows PowerShell inclui os seguintes aliases para Get-PSBreakpoint
:
gbp
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de