Disable-PSBreakpoint

  • Referens
Modul:
Microsoft.PowerShell.Utility

Inaktiverar brytpunkterna i den aktuella konsolen.

Syntax

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-Runspace <Runspace>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Cmdleten Disable-PSBreakpoint inaktiverar brytpunkter, vilket säkerställer att de inte träffas när skriptet körs. Du kan använda den för att inaktivera alla brytpunkter eller ange brytpunkter genom att skicka brytpunktsobjekt eller brytpunkts-ID:t.

Tekniskt sett ändrar den här cmdleten värdet för egenskapen Enabled för ett brytpunktsobjekt till False. Om du vill återaktivera en brytpunkt använder du cmdleten Enable-PSBreakpoint . Brytpunkter aktiveras som standard när du skapar dem med hjälp av cmdleten Set-PSBreakpoint .

En brytpunkt är en punkt i ett skript där körningen stoppas tillfälligt så att du kan granska instruktionerna i skriptet. Disable-PSBreakpoint är en av flera cmdletar som är utformade för felsökning av PowerShell-skript. Mer information om PowerShell-felsökningsprogrammet finns i about_Debuggers.

Exempel

Exempel 1: Ange en brytpunkt och inaktivera den

Dessa kommandon inaktiverar en nyskapad brytpunkt.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Cmdleten Set-PSBreakpoint skapar en brytpunkt för variabeln $Name i skriptet Sample.ps1 och sparar brytpunktsobjektet i variabeln $B . Cmdleten Disable-PSBreakpoint inaktiverar den nya brytpunkten. Den använder en pipelineoperator (|) för att skicka brytpunktsobjektet till $B cmdleten Disable-PSBreakpoint .

Som ett resultat av det här kommandot är värdet för egenskapen Aktiverad för brytpunktsobjektet i $B False.

Exempel 2: Inaktivera en brytpunkt

Det här kommandot inaktiverar brytpunkten med brytpunkts-ID 0.

Disable-PSBreakpoint -Id 0

Exempel 3: Skapa en inaktiverad brytpunkt

Det här kommandot skapar en ny brytpunkt som är inaktiverad tills du aktiverar den.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Den använder cmdleten Disable-PSBreakpoint för att inaktivera brytpunkten. Värdet för parametern Breakpoint är ett Set-PSBreakpoint kommando som anger en ny brytpunkt, genererar ett brytpunktsobjekt och sparar objektet i variabeln $B .

Cmdlet-parametrar som tar objekt som deras värden kan acceptera en variabel som innehåller objektet eller ett kommando som hämtar eller genererar objektet. I det här fallet, eftersom Set-PSBreakpoint genererar ett brytpunktsobjekt, kan det användas som värdet för parametern Breakpoint .

Exempel 4: Inaktivera alla brytpunkter i den aktuella konsolen

Det här kommandot inaktiverar alla brytpunkter i den aktuella konsolen.

`Get-PSBreakpoint` | Disable-PSBreakpoint

Exempel 5: Inaktivera en brytpunkt i ett runspace

I det här exemplet startas ett jobb och en brytpunkt ställs in på att brytas när det Set-PSBreakPoint körs. Runspace lagras i en variabel och skickas Get-PSBreakPoint till kommandot med parametern Runspace . Utdata Get-PSBreakPoint från skickas till för att Disable-PSBreakpoint inaktivera brytpunkten i runspace.

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

Parametrar

-Breakpoint

Anger brytpunkterna som ska inaktiveras. Ange en variabel som innehåller brytpunktsobjekt eller ett kommando som hämtar brytpunktsobjekt, till exempel ett Get-PSBreakpoint kommando. Du kan också skicka brytpunktsobjekt till cmdleten Disable-PSBreakpoint .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Inaktiverar brytpunkterna med angivna brytpunkts-ID:t. Ange ID:t eller en variabel som innehåller ID:t. Du kan inte skicka ID:t till Disable-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Returnerar ett objekt som representerar de aktiverade brytpunkterna. Som standard genererar den här cmdleten inga utdata.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Runspace

Anger ID för ett Runspace-objekt så att du kan interagera med brytpunkter i det angivna körningsutrymmet.

Den här parametern lades till i PowerShell 7.2.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

Breakpoint

Du kan skicka ett brytpunktsobjekt till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

Breakpoint

När du använder parametern PassThru returnerar den här cmdleten ett brytpunktsobjekt som representerar den inaktiverade brytpunkten.

Kommentarer

PowerShell innehåller följande alias för Disable-PSBreakpoint:

  • Alla plattformar:
    • dbp