Enable-PSBreakpoint
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 | ebp
lehet.
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, 5
felel 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-PSBreakPoint
parancsnak.
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
.
Típus: | Breakpoint[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Int32[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Runspace |
Aliasok: | RunspaceId |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Ehhez a parancsmaghoz töréspont-objektumot is csövezhet.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
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-PSBreakpoint
tartalmazza:
Ö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.