Disable-PSBreakpoint

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

Disable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-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 Windows PowerShell-skript. Mer information om Windows PowerShell-felsökningsprogrammet finns i about_Debuggers.

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Dessa kommandon inaktiverar en nyskapad brytpunkt.

Det första kommandot använder cmdleten Set-PSBreakpoint för att skapa en brytpunkt för variabeln Name i Sample.ps1-skriptet. Sedan sparas brytpunktsobjektet i variabeln $B.

Det andra kommandot använder cmdleten Disable-PSBreakpoint för att inaktivera 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 Aktiverad för brytpunktsobjektet i $B Falskt.

PS C:\> Disable-PSBreakpoint -Id 0

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

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

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

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 andra kommandot visar brytpunktsobjektet i värdet för variabeln $B.

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Det här kommandot inaktiverar alla brytpunkter i den aktuella konsolen. Du kan förkorta det här kommandot som: "gbp | dbp".

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 Disable-PSBreakpoint.

När du använder parametern PassThru returnerar Disable-PSBreakpoint ett objekt som representerar den inaktiverade brytpunkten. Annars genererar den här cmdleten inga utdata.