Compartir vía

Get-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

Line (Es el valor predeterminado). 

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

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

Un punto de interrupción es un punto de un comando o script donde la ejecución se detiene temporalmente para poder examinar las instrucciones. Get-PSBreakpoint es uno de los varios cmdlets diseñados para depurar scripts y comandos de PowerShell. Para obtener 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 de 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 canalizando un identificador de punto de interrupción a Get-PSBreakpoint.

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

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

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

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

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

Este comando no obtiene otros puntos de interrupción que podrían establecerse 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 command que se establecen en comandos Read-Host o Write-Host del archivo Sample.ps1.

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 command del archivo Sample.ps1.

Ejemplo 7: Obtener puntos de interrupción por variable

Este comando obtiene puntos de interrupción establecidos en las variables $Index y $Swap de 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 script de Sample.ps1.

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

Ejemplo 9: Obtener los puntos de interrupción establecidos en un espacio de ejecución específico

En este ejemplo, se inicia un trabajo y se establece un punto de interrupción para interrumpir cuando se ejecuta el Set-PSBreakpoint. El espacio de ejecución se almacena en una variable y se pasa al comando Get-PSBreakpoint con el parámetro Runspace. A continuación, puede inspeccionar el punto de interrupción en la variable $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 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 una función.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Command
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 para Get-PSBreakpoint.

Propiedades del parámetro

Tipo:

Int32[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Id
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Este parámetro se agregó en PowerShell 7.2.

Propiedades del parámetro

Tipo:Runspace
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 omite la ruta de acceso, la ubicación predeterminada es el directorio actual.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Script
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Variable
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Command
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Type
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Type

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

  • Línea
  • Comando
  • Variable

También puede canalizar tipos de punto de interrupción para Get-PSBreakpoint.

Propiedades del parámetro

Tipo:

BreakpointType[]

Valor predeterminado:None
Valores aceptados:Line, Variable, Command
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Type
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 las variables sin signos de dólar.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Variable
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Int32

Puede canalizar los identificadores de punto de interrupción a este cmdlet.

BreakpointType

Puede canalizar los tipos de punto de interrupción a este cmdlet.

Salidas

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Este cmdlet devuelve objetos que representan los puntos de interrupción de la sesión.

Notas

PowerShell incluye los siguientes alias para Get-PSBreakpoint:

  • Todas las plataformas:
    • gbp