Disable-PSBreakpoint

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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 $Bengedé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-PSBreakPointparancsnak. 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.

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

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: .

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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, a letiltott töréspontot képviselő töréspont-objektumot ad vissza.

Jegyzetek

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

  • Minden platform:
    • dbp