Share via

Enable-PSBreakpoint

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Engedélyezi a töréspontokat az aktuális konzolon.

Syntax

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

A Enable-PSBreakpoint parancsmag újra engedélyezi a letiltott töréspontokat. Ezzel engedélyezheti az összes töréspontot vagy adott töréspontot töréspont-objektumok vagy azonosítók megadásával.

A töréspont egy olyan pont a szkriptben, ahol a végrehajtás ideiglenesen leáll, hogy megvizsgálhassa a szkript állapotát. Az újonnan létrehozott töréspontok automatikusan engedélyezve vannak, de letilthatók a használatával Disable-PSBreakpoint.

Ez a parancsmag technikailag Igaz értékre módosítja egy töréspont objektum Engedélyezett tulajdonságának értékét.

Enable-PSBreakpoint A PowerShell-szkriptek hibakereséséhez 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 töréspont engedélyezése

Ez a példa az aktuális munkamenet összes töréspontját engedélyezi.

Get-PSBreakpoint | Enable-PSBreakpoint

Aliasok használatával ez a példa rövidítve is gbp | ebplehet.

2. példa: Töréspontok engedélyezése azonosító szerint

Ez a példa több töréspont használatát teszi lehetővé a töréspontok azonosítóinak használatával.

Enable-PSBreakpoint -Id 0, 1, 5

3. példa: Letiltott töréspont engedélyezése

Ez a példa újra engedélyezi a letiltott töréspontot.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint létrehoz egy töréspontot a névváltozón a Sample.ps1 szkriptben, amely menti a töréspont objektumot a $B változóban. A PassThru paraméter a töréspont Engedélyezve tulajdonságának értéke Hamis.

Enable-PSBreakpoint újra engedélyezi a töréspontot. A PassThru paraméterrel ismét azt látjuk, hogy az Engedélyezett tulajdonság értéke Igaz.

4. példa: Töréspontok engedélyezése változóval

Ez a példa a töréspontok objektumait használó töréspontok készletét teszi lehetővé.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint lekéri a töréspontokat, és menti őket a $B változóba. A Töréspont paraméterrel Enable-PSBreakpoint engedélyezheti a töréspontokat.

Ez a példa a futtatásnak Enable-PSBreakpoint -Id 3, 5felel meg.

5. példa: Töréspont engedélyezése egy runspace-ben

Ebben a példában a feladat egy törésponttal kezdődik, és le van tiltva. A runspace egy változóban van tárolva, és a Runspace paraméterrel továbbítja a Get-PSBreakPointparancsnak. A kimenet Get-PSBreakPoint úgy van beállítva, hogy Enable-PSBreakpoint engedélyezze a töréspontot a runspace-ben.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Paraméterek

-Breakpoint

Megadja az engedélyezni kívánt töréspontokat. Adjon meg egy töréspontokat tartalmazó változót vagy egy olyan parancsot, amely töréspont-objektumokat kap, például Get-PSBreakpoint. A töréspont-objektumokat is becsúszthatja a parancsba Enable-PSBreakpoint.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Megadja az engedélyezni kívánt töréspontok azonosítószámait . Az alapértelmezett érték az összes töréspont. Adja meg az azonosítót szám vagy változó alapján. Az azonosítószámokat nem lehet becsúszni.Enable-PSBreakpoint A töréspont azonosítójának megkereséséhez használja a Get-PSBreakpoint parancsmagot.

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

-PassThru

Az engedélyezve lévő töréspontot képviselő objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

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

-Runspace

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

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

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

Breakpoint

Ehhez a parancsmaghoz töréspont-objektumot is csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

Breakpoint

A PassThru paraméter használatakor ez a parancsmag egy, az engedélyezett töréspontot képviselő töréspont-objektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat Enable-PSBreakpointtartalmazza:

  • Összes platform:

    • ebp

  • A Enable-PSBreakpoint parancsmag nem okoz hibát, ha egy már engedélyezett töréspontot próbál engedélyezni. Így az összes töréspontot hiba nélkül engedélyezheti, még akkor is, ha csak néhány van letiltva.

  • A töréspontok akkor lesznek engedélyezve, ha a Set-PSBreakpoint parancsmag használatával hozza létre őket. Nem kell engedélyeznie az újonnan létrehozott töréspontokat.