Get-PSBreakpoint
Obtiene los puntos de interrupción establecidos en la sesión actual.
Sintaxis
Script (valor predeterminado)
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
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 Windows PowerShell. Para obtener más información sobre el depurador de Windows PowerShell, consulte about_Debuggers.
Ejemplos
Ejemplo 1: Obtención de todos los puntos de interrupción para todos los scripts y funciones
PS C:\> Get-PSBreakpoint
Este comando obtiene todos los puntos de interrupción establecidos en todos los scripts y funciones de la sesión actual.
Ejemplo 2: Obtener puntos de interrupción por identificador
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 obtiene el punto de interrupción con el identificador de punto de interrupción 2.
Ejemplo 3: Canalización de un identificador a Get-PSBreakpoint
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint
Estos comandos muestran cómo obtener un punto de interrupción canalizando un identificador de punto de interrupción para Get-PSBreakpoint.
El primer comando usa el cmdlet Set-PSBreakpoint para crear un punto de interrupción en la función Increment en el script de Sample.ps1. Guarda el objeto de punto de interrupción en la variable $B.
El segundo comando usa el operador dot (.) para obtener la propiedad Id del objeto de punto de interrupción en la variable $B. Usa 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: Obtener puntos de interrupción en archivos de script especificados
PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"
Este comando obtiene todos los puntos de interrupción de los archivos Sample.ps1 y 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
PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"
Este comando obtiene todos los puntos de interrupción command que se establecen en comandos Read-Host o Write-Host del archivo Sample.ps1.
Ejemplo 6: Obtener puntos de interrupción de comando en un archivo especificado
PS C:\> 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
PS C:\> Get-PSBreakpoint -Variable "Index, Swap"
Este comando obtiene puntos de interrupción que se establecen en las variables $Index y $Swap de la sesión actual.
Ejemplo 8: Obtener todos los puntos de interrupción de línea y variable en un archivo
PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Este comando obtiene todos los puntos de interrupción de línea y variable en el script de 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 una función.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Command
| Posición: | Named |
| Obligatorio: | 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 de parámetro
| Tipo: | Int32[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Id
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| 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 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 de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Script
| Posición: | 0 |
| Obligatorio: | 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: | 0 |
| Obligatorio: | 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: | 0 |
| Obligatorio: | 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: | 0 |
| Obligatorio: | 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 los tipos de punto de interrupción para Get-PSBreakPoint.
Propiedades de 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 |
| Obligatorio: | 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 de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Variable
| Posición: | Named |
| Obligatorio: | 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
System.Int32, Microsoft.PowerShell.Commands.BreakpointType
Puede canalizar identificadores de punto de interrupción y tipos de punto de interrupción para Get-PSBreakPoint.
Salidas
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".