Disable-PSBreakpoint
Inaktiverar brytpunkterna i den aktuella konsolen.
Syntax
Breakpoint (Standard)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-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 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.
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 Brytpunkt.
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 Disable-PSBreakpoint cmdlet.
Parameteregenskaper
| Typ: | |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Breakpoint
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | Int32[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Id
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-PassThru
Returnerar ett objekt som representerar de aktiverade brytpunkterna. Som standard genererar den här cmdleten inga utdata.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
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.
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 returneras ett objekt som representerar den inaktiverade brytpunkten. Annars genererar den här cmdleten inga utdata.