Remove-PSBreakpoint (Microsoft.PowerShell.Utility)

Remove-PSBreakpoint

Modul:

Microsoft.PowerShell.Utility

Törli a töréspontokat az aktuális konzolról.

Szintaxis

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PSBreakpoint
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Leírás

A Remove-PSBreakpoint parancsmag törli a töréspontot. Adjon meg egy töréspont objektumot vagy egy töréspont azonosítót.

Ha eltávolít egy töréspontot, a töréspont objektum már nem elérhető vagy nem működik. Ha elmentett egy töréspont objektumot egy változóba, a hivatkozás továbbra is létezik, de a töréspont nem működik.

A Remove-PSBreakpoint egyike a PowerShell-szkriptek hibakeresésére tervezett parancsmagoknak. A PowerShell hibakeresővel kapcsolatos további információkért lásd: about_Debuggers.

Példák

1. példa: Távolítsa el az összes töréspontot

Ez a parancs törli az összes töréspontot az aktuális konzolon.

Get-PSBreakpoint | Remove-PSBreakpoint

2. példa: Távolítsa el a megadott töréspontot

Ez a parancs törli a töréspontot.

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

A Set-PSBreakpoint parancsmag töréspontot hoz létre a $Name változóban a Sample.ps1 szkriptben, és elmenti a töréspont objektumot a fájlba. $B változó. A Remove-PSBreakpoint parancsmag törli az új töréspontot. Egy folyamatoperátor (|) segítségével küldi el a $B változóban lévő töréspont objektumot a Remove-PSBreakpoint parancsmagnak.

Ennek a parancsnak az eredményeként, ha futtatja a szkriptet, az leállás nélkül lefut a végéig. Ezenkívül a Get-PSBreakpoint parancsmag nem adja vissza ezt a töréspontot.

3. példa: Töréspont eltávolítása azonosító alapján

Ez a parancs törli a 2. töréspontazonosítójú töréspontot.

Remove-PSBreakpoint -Id 2

4. példa: Egy függvény segítségével távolítsa el az összes töréspontot

Ez az egyszerű funkció törli az összes töréspontot az aktuális munkamenetben.

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

A Get-PSBreakpoint parancsmagot használja a töréspontok lekéréséhez. Ezután egy folyamatoperátor (|) segítségével elküldi a töréspontokat a Remove-PSBreakpoint parancsmagnak, amely törli azokat.

5. példa: Távolítson el egy töréspontot egy futási területen

Ebben a példában egy job elindul, és a töréspont megszakításra van beállítva, amikor a Set-PSBreakPoint fut. A futási területet a rendszer egy változóban tárolja, és átadja a Get-PSBreakPoint parancsnak a Runspace paraméterrel. A Get-PSBreakPoint kimenete a Remove-PSBreakPoint fájlba kerül, hogy eltávolítsa a töréspontot a futási térből.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

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

Paraméterek

-Breakpoint

Megadja a törlendő töréspontokat. Adjon meg egy változót, amely töréspont objektumokat tartalmaz, vagy egy parancsot, amely töréspont objektumokat kap, például egy Get-PSBreakpoint parancsot. A töréspont objektumokat a Remove-PSBreakpoint-ba is átállíthatja.

Típus:

Töréspont[]

Pozíció:

0

Alapértelmezett érték:

None

Kívánt:

True

Csővezeték bevitel elfogadása:

True

Helyettesítő karakterek elfogadása:

False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Típus:

SwitchParameter

Álnevek:

cf

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Id

Meghatározza azokat a töréspont-azonosítókat, amelyekhez ez a parancsmag törli a töréspontokat.

Típus:

Int32[]

Pozíció:

0

Alapértelmezett érték:

None

Kívánt:

True

Csővezeték bevitel elfogadása:

True

Helyettesítő karakterek elfogadása:

False

-Runspace

Megadja egy Runspace objektum azonosítóját, hogy interakcióba léphessen a megadott futási területen lévő töréspontokkal.

Ezt a paramétert a PowerShell 7.2-ben adták hozzá.

Típus:

Runspace

Álnevek:

RunspaceId

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

True

Helyettesítő karakterek elfogadása:

False

-WhatIf

Megmutatja, mi történik, ha a parancsmag lefut. A parancsmag nem fut.

Típus:

SwitchParameter

Álnevek:

wi

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

Bemenetek

Szünetpont[]

A töréspont objektumokat ebbe a parancsmagba irányíthatja.

Int32[]

Runspace

Kimenetek

Nincs

Ez a parancsmag nem ad vissza kimenetet.

Megjegyzések

A PowerShell a következő álneveket tartalmazza a Remove-PSBreakpoint számára:

• Minden platform:

  rbp