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

Sintaxis

Get-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>]

Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>]

Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>]

Get-PSBreakpoint [-Type] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>]

Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]

Descripción

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

Un punto de interrupción es un punto en un comando o script donde la ejecución se detiene temporalmente para que se puedan examinar las instrucciones incluidas en el script. Get-PSBreakpoint es uno de los diversos cmdlets diseñados para la depuración de los scripts y comandos de Windows PowerShell. Para obtener más información acerca del depurador de Windows PowerShell, vea about_Debuggers.

Parámetros

-Command <string[]>

Obtiene los puntos de interrupción de comando establecidos en los nombres de comando especificados. Escriba los nombres de comando, como el nombre de un cmdlet o una función.

¿Requerido?

true

¿Posición?

named

Valor predeterminado

All breakpoints

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Id <Int32[]>

Obtiene los puntos de interrupción con los identificadores especificados. Escriba los identificadores en una lista delimitada por comas. También puede canalizar los identificadores de los puntos de interrupción a Get-PSBreakpoint.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

All breakpoints

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Script <string[]>

Obtiene solamente los puntos de interrupción de los scripts especificados. Escriba la ruta de acceso (opcional) y el nombre de uno o varios archivos de script. La ubicación predeterminada es el directorio actual.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

All breakpoints

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Type <BreakpointType[]>

Obtiene únicamente los puntos de interrupción de los tipos especificados. Especifique uno o varios tipos. Los valores válidos son Line, Command y Variable. También puede canalizar los tipos de punto de interrupción a Get-PSBreakpoint.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

All breakpoints

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Variable <string[]>

Obtiene los puntos de interrupción de variable establecidos en los nombres de variable especificados. Escriba los nombres de variable sin signo de dólar.

¿Requerido?

true

¿Posición?

named

Valor predeterminado

All breakpoints

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

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

Salidas

Objeto de punto de interrupción (System.Management.Automation.LineBreakpoint, System.Management.Automation.VariableBreakpoint, System.Management.Automation.CommandBreakpoint)

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

Notas

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

Ejemplo 1

C:\PS>get-psbreakpoint

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






Ejemplo 2

C:\PS>get-psbreakpoint -Id 2

Function   : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 2
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

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






Ejemplo 3

C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment

C:\PS> $b.Id | get-psbreakpoint

Descripción
-----------
Estos comandos muestran cómo se obtiene un punto de interrupción canalizando un identificador de punto de interrupción a Get-PSBreakpoint.

El primer comando utiliza el cmdlet Set-PSBreakpoint para crear un punto de interrupción en la función Increment del script Sample.ps1. Guarda el objeto de punto de interrupción en la variable $b.

El segundo comando usa el operador de punto (.) para obtener la propiedad Id del objeto de punto de interrupción almacenado en la variable $b. Utiliza un operador de canalización (|) para enviar el identificador al cmdlet Get-PSBreakpoint.

Como resultado, Get-PSBreakpoint obtiene el punto de interrupción con el identificador especificado.






Ejemplo 4

C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1

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

Este comando no obtiene los puntos de interrupción establecidos en otros scripts o funciones de la sesión.






Ejemplo 5

C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1

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






Ejemplo 6

C:\PS>get-psbreakpoint -type Command -script Sample.ps1

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






Ejemplo 7

C:\PS>get-psbreakpoint -variable Index, Swap

Descripción
-----------
Este comando obtiene los puntos de interrupción establecidos en las variables $index y $swap de la sesión actual.






Ejemplo 8

C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1

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






Vea también




Tabla de contenido