Disable-PSBreakpoint
Letiltja a töréspontokat az aktuális konzolon.
Syntax
Breakpoint (Alapértelmezett)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-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 Windows PowerShell-szkriptek hibakeresésére tervezett parancsmagok egyike. A Windows PowerShell hibakeresőjé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
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint
Ezek a parancsok letiltanak egy újonnan létrehozott töréspontot.
Az első parancs a Set-PSBreakpoint parancsmaggal hoz létre töréspontot a Név változón a Sample.ps1 szkriptben. Ezután menti a töréspont-objektumot a $B változóba.
A második parancs a Disable-PSBreakpoint parancsmaggal tiltja le az új töréspontot. Folyamatkezelőt (|) használ a töréspont-objektum $B Disable-PSBreakpoint parancsmagba való küldéséhez.
Ennek a parancsnak az eredményeként a töréspont objektum engedélyezett tulajdonságának értéke a $B hamis.
2. példa: Töréspont letiltása
PS C:\> Disable-PSBreakpoint -Id 0
Ez a parancs letiltja a töréspontot a 0-s töréspont-azonosítóval.
3. példa: Letiltott töréspont létrehozása
PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B
Ez a parancs létrehoz egy új töréspontot, amely le van tiltva, amíg nem engedélyezi azt.
A töréspont letiltásához a Disable-PSBreakpoint parancsmagot használja. A Töréspont paraméter értéke egy Set-PSBreakpoint 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óba.
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 létrehoz egy töréspont-objektumot, a Töréspont paraméter értékeként használható.
A második parancs megjeleníti a töréspont-objektumot a $B változó értékében.
4. példa: Az összes töréspont letiltása az aktuális konzolon
PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint
Ez a parancs letiltja az aktuális konzol összes töréspontját. A parancs rövidítése a következő: "gbp | dbp".
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 kap, például egy Get-PSBreakpoint parancsot. Töréspont-objektumokat a Disable-PSBreakpoint parancsmagra is csövezhet.
Paramétertulajdonságok
| Típus: | Breakpoint[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Breakpoint
| 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 |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
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 |
-Id
A töréspont-azonosítókat tartalmazó azonosítók vagy változók tömbje.
A Disable-PSBreakpoint
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: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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 |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
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 |
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
Breakpoint
A töréspont-objektumokat a Disable-PSBreakpoint
Kimenetek
None or System.Management.Automation.Breakpoint
Ha a PassThru paramétert használja, Disable-PSBreakpoint egy olyan objektumot ad vissza, amely a letiltott töréspontot jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.