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 nås 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 Falskt. 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 $B till cmdleten Disable-PSBreakpoint .

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

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 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ärde 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 .

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 denna cmdlet inga utdata.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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 Disable-PSBreakpoint.

Utdata

None or System.Management.Automation.Breakpoint

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