Disable-PSBreakpoint

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

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

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.

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 Sample.ps1-skriptet och sparar brytpunktsobjektet i variabeln $B. Cmdleten Disable-PSBreakpoint inaktiverar den nya brytpunkten. Den använder en pipelineoperator (|) för att skicka brytpunktsobjektet i $B till cmdleten Disable-PSBreakpoint.

Som ett resultat av det här kommandot är värdet för egenskapen Enabled för brytpunktsobjektet i $BFalse.

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

Disable-PSBreakpoint -Id 0

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

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

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

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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

Som standard returnerar den här cmdleten inga utdata.

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

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

• Alla plattformar:
  • dbp