Delen via

Disable-PSBreakpoint

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee worden de onderbrekingspunten in de huidige console uitgeschakeld.

Syntaxis

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

Description

Met de Disable-PSBreakpoint-cmdlet worden onderbrekingspunten uitgeschakeld, wat ervoor zorgt dat ze niet worden bereikt wanneer het script wordt uitgevoerd. U kunt dit gebruiken om alle onderbrekingspunten uit te schakelen of u kunt onderbrekingspunten opgeven door onderbrekingspuntobjecten of onderbrekingspunt-id's in te dienen.

Technisch gezien wijzigt deze cmdlet de waarde van de eigenschap Ingeschakeld van een onderbrekingspuntobject in False. Als u een onderbrekingspunt opnieuw wilt inschakelen, gebruikt u de cmdlet Enable-PSBreakpoint. Onderbrekingspunten worden standaard ingeschakeld wanneer u ze maakt met behulp van de Set-PSBreakpoint-cmdlet.

Een onderbrekingspunt is een punt in een script waarbij de uitvoering tijdelijk stopt, zodat u de instructies in het script kunt bekijken. Disable-PSBreakpoint is een van de verschillende cmdlets die zijn ontworpen voor het opsporen van fouten in PowerShell-scripts. Zie about_Debuggersvoor meer informatie over het PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Een onderbrekingspunt instellen en uitschakelen

Met deze opdrachten wordt een nieuw onderbrekingspunt uitgeschakeld.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

De cmdlet Set-PSBreakpoint maakt een onderbrekingspunt op de $Name variabele in het Sample.ps1 script en slaat het onderbrekingspuntobject op in de $B variabele. Met de cmdlet Disable-PSBreakpoint wordt het nieuwe onderbrekingspunt uitgeschakeld. Er wordt een pijplijnoperator (|) gebruikt om het onderbrekingspuntobject in $B naar de Disable-PSBreakpoint-cmdlet te verzenden.

Als gevolg van deze opdracht wordt de waarde van de eigenschap Ingeschakeld van het onderbrekingspuntobject in $BOnwaar.

Voorbeeld 2: Een onderbrekingspunt uitschakelen

Met deze opdracht wordt het onderbrekingspunt met onderbrekingspunt-id 0 uitgeschakeld.

Disable-PSBreakpoint -Id 0

Voorbeeld 3: Een uitgeschakeld onderbrekingspunt maken

Met deze opdracht maakt u een nieuw onderbrekingspunt dat is uitgeschakeld totdat u dit inschakelt.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

De cmdlet Disable-PSBreakpoint wordt gebruikt om het onderbrekingspunt uit te schakelen. De waarde van de parameter Onderbrekingspunt is een Set-PSBreakpoint opdracht waarmee een nieuw onderbrekingspunt wordt ingesteld, een onderbrekingspuntobject wordt gegenereerd en het object wordt opgeslagen in de $B variabele.

Cmdlet-parameters die objecten als hun waarden gebruiken, kunnen een variabele accepteren die het object bevat of een opdracht waarmee het object wordt opgehaald of gegenereerd. Omdat Set-PSBreakpoint in dit geval een onderbrekingspuntobject genereert, kan het worden gebruikt als de waarde van de parameter Onderbrekingspunt.

Voorbeeld 4: Alle onderbrekingspunten in de huidige console uitschakelen

Met deze opdracht worden alle onderbrekingspunten in de huidige console uitgeschakeld.

`Get-PSBreakpoint` | Disable-PSBreakpoint

Parameters

-Breakpoint

Hiermee geeft u de onderbrekingspunten die moeten worden uitgeschakeld. Voer een variabele in die onderbrekingspuntobjecten of een opdracht bevat waarmee onderbrekingspuntobjecten worden opgehaald, zoals een Get-PSBreakpoint opdracht. U kunt ook onderbrekingspuntobjecten doorsluisen naar de Disable-PSBreakpoint cmdlet.

Type:Breakpoint[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee schakelt u de onderbrekingspunten uit met de opgegeven onderbrekingspunt-id's. Voer de id's of een variabele in die de id's bevat. U kunt geen id's naar Disable-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert een object dat de ingeschakelde onderbrekingspunten vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Breakpoint

U kunt een onderbrekingspuntobject doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

Breakpoint

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een onderbrekingspuntobject dat het uitgeschakelde onderbrekingspunt vertegenwoordigt.

Notities

Windows PowerShell bevat de volgende aliassen voor Disable-PSBreakpoint:

  • dbp