Megosztás a következőn keresztül:

Get-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Lekéri az aktuális munkamenetben beállított töréspontokat.

Syntax

Line (Alapértelmezett) 

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

A Get-PSBreakPoint parancsmag lekéri az aktuális munkamenetben beállított töréspontokat. A parancsmag paramétereit használva lekérheti az adott töréspontokat.

A töréspont egy olyan pont egy parancsban vagy szkriptben, ahol a végrehajtás ideiglenesen leáll, hogy megvizsgálhassa az utasításokat. Get-PSBreakpoint a PowerShell-szkriptek és -parancsok hibakeresésére tervezett számos parancsmag egyike. A PowerShell-hibakeresővel kapcsolatos további információkért lásd: about_Debuggers.

Példák

1. példa: Az összes szkript és függvény töréspontjainak lekérése

Ez a parancs beolvas minden töréspontot az aktuális munkamenet összes szkriptjén és függvényén.

Get-PSBreakpoint

2. példa: Töréspontok lekérése azonosító alapján

Ez a parancs lekéri a töréspontot a 2. töréspont-azonosítóval.

Get-PSBreakpoint -Id 2

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

3. példa: Azonosító beolvasása a Get-PSBreakpointba

Ezek a parancsok bemutatják, hogyan lehet töréspontot lekérni egy töréspont azonosítójával a Get-PSBreakpoint.

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

A Set-PSBreakpoint parancsmag létrehoz egy töréspontot a növekmény függvényen a Sample.ps1 szkriptben, és menti a töréspont objektumot a $B változóban. A változóban lévő töréspont objektum $B azonosítója a Get-PSBreakpoint parancsmagra van állítva a töréspont adatainak megjelenítéséhez.

4. példa: Töréspontok lekérése megadott szkriptfájlokban

Ez a parancs lekéri a Sample.ps1 és SupportScript.ps1 fájlok összes töréspontját.

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

Ez a parancs nem kap más töréspontokat, amelyek más szkriptekben vagy a munkamenet függvényeiben állíthatók be.

5. példa: Töréspontok lekérése megadott parancsmagokban

Ez a parancs lekéri a Read-Host fájlban Write-Host vagy Sample.ps1 parancsokra beállított összes parancstörési pontot.

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

6. példa: Parancstöréspontok lekérése egy megadott fájlban

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

Ez a parancs lekéri az Sample.ps1 fájlban található összes parancstörési pontot.

7. példa: Töréspontok lekérése változó szerint

Ez a parancs olyan töréspontokat kap, amelyek az aktuális munkamenet $Index és $Swap változóira vannak beállítva.

Get-PSBreakpoint -Variable "Index, Swap"

8. példa: Az összes sor- és változótöréspont lekérése egy fájlban

Ez a parancs lekéri a Sample.ps1 szkript összes sor- és változótörési pontjának értékét.

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

9. példa: Adott futtatótérben beállított töréspontok lekérése

Ebben a példában egy feladat indul el, és a töréspont a Set-PSBreakPoint futtatásakor megszakad. A runspace egy változóban van tárolva, és a Get-PSBreakPoint parancsnak továbbítja a Runspace paraméterrel. Ezután megvizsgálhatja a töréspontot a $breakpoint változóban.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Paraméterek

-Command

A megadott parancsneveken beállított parancstöréspontok tömbje. Adja meg a parancsneveket, például egy parancsmag vagy függvény nevét.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Command
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Id

Megadja a parancsmag által lekért töréspont-azonosítókat. Írja be az azonosítókat egy vesszővel tagolt listában. A töréspont-azonosítókat a Get-PSBreakpointis használhatja.

Paramétertulajdonságok

Típus:

Int32[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Id
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Runspace

Egy runspace objektum azonosítóját adja meg, hogy a megadott runspace-ben használhassa a töréspontokat.

Ez a paraméter a PowerShell 7.2-ben lett hozzáadva.

Paramétertulajdonságok

Típus:Runspace
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Script

A töréspontokat tartalmazó szkriptek tömbje. Adja meg egy vagy több szkriptfájl elérési útját (nem kötelező) és nevét. Ha kihagyja az elérési utat, az alapértelmezett hely az aktuális könyvtár.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Script
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
Variable
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
Command
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
Type
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Type

A parancsmag által lekért törésponttípusok tömbje. Adjon meg egy vagy több típust. A paraméter elfogadható értékei a következők:

  • Sor
  • Parancs
  • Változó

A törésponttípusokat a Get-PSBreakPointis használhatja.

Paramétertulajdonságok

Típus:

BreakpointType[]

Alapértelmezett érték:None
Elfogadott értékek:Line, Variable, Command
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Type
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Variable

A megadott változóneveken beállított változótörési pontok tömbje. Adja meg a változóneveket dollárjelek nélkül.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Variable
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

Int32

Ehhez a parancsmaghoz töréspont-azonosítókat csövezhet.

BreakpointType

Ehhez a parancsmaghoz csőtöréspont-típusokat is használhat.

Kimenetek

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Ez a parancsmag olyan objektumokat ad vissza, amelyek a munkamenet töréspontjait jelölik.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Get-PSBreakpoint:

  • Minden platform:
    • gbp