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[]>
       [-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

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 .

Typ:Breakpoint[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Int32[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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

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

  • dbp