Get-PSBreakpoint

Obtiene los puntos de interrupción establecidos en la sesión actual.

Syntax

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

El Get-PSBreakPoint cmdlet obtiene los puntos de interrupción establecidos en la sesión actual. Los parámetros del cmdlet se pueden usar para obtener puntos de interrupción concretos.

Un punto de interrupción es un punto en un comando o script en el que la ejecución se detiene temporalmente para que se puedan examinar las instrucciones. Get-PSBreakpoint es uno de los varios cmdlets diseñados para depurar scripts y comandos de PowerShell. Para más información sobre el depurador de PowerShell, consulte about_Debuggers.

Ejemplos

Ejemplo 1: Obtención de todos los puntos de interrupción para todos los scripts y funciones

Este comando obtiene todos los puntos de interrupción establecidos en todos los scripts y funciones en la sesión actual.

Get-PSBreakpoint

Ejemplo 2: Obtener puntos de interrupción por identificador

Este comando obtiene el punto de interrupción con el identificador de punto de interrupción 2.

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Ejemplo 3: Canalización de un identificador a "Get-PSBreakpoint"

Estos comandos muestran cómo obtener un punto de interrupción mediante la canalización de un identificador de punto de interrupción a Get-PSBreakpoint.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

El Set-PSBreakpoint cmdlet crea un punto de interrupción en la función Increment en el Sample.ps1 script y guarda el objeto de punto de interrupción en la $B variable . La propiedad Id del objeto de punto de interrupción de la $B variable se canaliza al Get-PSBreakpoint cmdlet para mostrar la información del punto de interrupción.

Ejemplo 4: Obtener puntos de interrupción en los archivos de script especificados

Este comando obtiene todos los puntos de interrupción de los Sample.ps1 archivos y SupportScript.ps1 .

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Este comando no obtiene otros puntos de interrupción que se pueden establecer en otros scripts o en funciones de la sesión.

Ejemplo 5: Obtener puntos de interrupción en cmdlets especificados

Este comando obtiene todos los puntos de interrupción comando establecidos en Read-Host o Write-Host comandos del Sample.ps1 archivo.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Ejemplo 6: Obtener puntos de interrupción de comando en un archivo especificado

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Este comando obtiene todos los puntos de interrupción de comando en el archivo Sample.ps1.

Ejemplo 7: Obtener puntos de interrupción por variable

Este comando obtiene puntos de interrupción establecidos en las $Index variables y $Swap en la sesión actual.

Get-PSBreakpoint -Variable "Index, Swap"

Ejemplo 8: Obtener todos los puntos de interrupción de línea y variable en un archivo

Este comando obtiene todos los puntos de interrupción de línea y variable en el Sample.ps1 script.

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

Parámetros

-Command

Especifica una matriz de puntos de interrupción de comandos que se establecen en los nombres de comando especificados. Escriba los nombres de comando, como el nombre de un cmdlet o de una función.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica los identificadores de punto de interrupción que obtiene este cmdlet. Escriba los identificadores en una lista separada por comas. También puede canalizar los identificadores de punto de interrupción a Get-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Runspace

Especifica el identificador de un objeto Runspace para que pueda interactuar con puntos de interrupción en el espacio de ejecución especificado.

Type:Runspace
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Script

Especifica una matriz de scripts que contienen los puntos de interrupción. Escriba la ruta de acceso (opcional) y los nombres de uno o varios archivos de script. Si se omite la ruta de acceso, la ubicación predeterminada es el directorio actual.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Type

Especifica una matriz de tipos de punto de interrupción que obtiene este cmdlet. Escriba uno o varios tipos. Los valores permitidos para este parámetro son los siguientes:

  • Línea
  • Comando
  • Variable

También puede canalizar tipos de punto de interrupción a Get-PSBreakPoint.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Variable

Especifica una matriz de puntos de interrupción de variables que se establecen en los nombres de variable especificados. Escriba los nombres de variable sin signos de dólar.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Int32

BreakpointType

Puede canalizar los identificadores de punto de interrupción y los tipos de punto de interrupción a Get-PSBreakPoint.

Salidas

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Get-PSBreakPoint devuelve objetos que representan los puntos de interrupción de la sesión.

Notas

Puede usar Get-PSBreakpoint o su alias, "gbp".