Disable-PSBreakpoint
Letiltja a töréspontokat az aktuális konzolon.
Syntax
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Disable-PSBreakpoint
parancsmag letiltja a töréspontokat, ami biztosítja, hogy a szkript futtatásakor ne legyenek találatok. Ezzel letilthatja az összes töréspontot, vagy töréspontokat adhat meg töréspontok objektumainak vagy töréspontazonosítóinak elküldésével.
Ez a parancsmag technikailag hamis értékre módosítja egy töréspont objektum Engedélyezett tulajdonságának értékét.
Töréspont újbóli engedélyezéséhez használja a Enable-PSBreakpoint
parancsmagot. A töréspontok alapértelmezés szerint engedélyezve vannak, amikor a Set-PSBreakpoint
parancsmaggal hozza létre őket.
A töréspont egy olyan pont a szkriptben, ahol a végrehajtás ideiglenesen leáll, így megvizsgálhatja a szkript utasításait. Disable-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: Töréspont beállítása és letiltása
Ezek a parancsok letiltanak egy újonnan létrehozott töréspontot.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
A Set-PSBreakpoint
parancsmag létrehoz egy töréspontot a $Name
változón a Sample.ps1
szkriptben, és menti a töréspont objektumot a $B
változóban. A Disable-PSBreakpoint
parancsmag letiltja az új töréspontot. Egy folyamatkezelővel (|
) küldi be $B
a töréspont-objektumot a Disable-PSBreakpoint
parancsmagba.
Ennek a parancsnak az eredményeként a töréspont objektum $B
engedélyezett tulajdonságának értéke Hamis.
2. példa: Töréspont letiltása
Ez a parancs letiltja a töréspontot a 0-s töréspont-azonosítóval.
Disable-PSBreakpoint -Id 0
3. példa: Letiltott töréspont létrehozása
Ez a parancs létrehoz egy új töréspontot, amely le van tiltva, amíg nem engedélyezi azt.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
A parancsmaggal Disable-PSBreakpoint
tiltja le a töréspontot. A Breakpoint paraméter értéke egy Set-PSBreakpoint
olyan parancs, amely beállít egy új töréspontot, létrehoz egy töréspont-objektumot, és menti az objektumot a $B
változóban.
Azok a parancsmagparaméterek, amelyek az értékekként veszik át az objektumokat, elfogadhatnak egy változót, amely tartalmazza az objektumot, vagy egy parancsot, amely lekéri vagy létrehozza az objektumot. Ebben az esetben, mivel Set-PSBreakpoint
töréspont-objektumot hoz létre, a Töréspont paraméter értékeként használható.
4. példa: Az összes töréspont letiltása az aktuális konzolon
Ez a parancs letiltja az aktuális konzol összes töréspontját.
`Get-PSBreakpoint` | Disable-PSBreakpoint
5. példa: Töréspont letiltása egy runspace-ben
Ebben a példában egy feladat elindul, a töréspont pedig a futtatáskor Set-PSBreakPoint
megszakad. A runspace egy változóban van tárolva, és a Runspace paraméterrel továbbítja a Get-PSBreakPoint
parancsnak. A kimenet úgy van beállítva, hogy Disable-PSBreakpoint
letiltsa Get-PSBreakPoint
a töréspontot a futtatótérben.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace
Paraméterek
-Breakpoint
Megadja a letiltani kívánt töréspontokat. Adjon meg egy olyan változót, amely töréspont-objektumokat tartalmaz, vagy olyan parancsot, amely töréspont-objektumokat (például parancsokat Get-PSBreakpoint
) kap. A parancsmaghoz Disable-PSBreakpoint
töréspont-objektumokat is csövezhet.
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
Letiltja a töréspontokat a megadott töréspont-azonosítókkal. Adja meg az azonosítókat vagy az azonosítókat tartalmazó változót. Az azonosítókat nem lehet becsúszni a következőbe Disable-PSBreakpoint
: .
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élyezett töréspontokat 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, a letiltott töréspontot képviselő töréspont-objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat Disable-PSBreakpoint
tartalmazza:
- Minden platform:
dbp