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

De cmdlet Disable-PSBreakpoint schakelt onderbrekingspunten uit, 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 cmdlet Set-PSBreakpoint.

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 Windows PowerShell-scripts. Zie about_Debuggers voor meer informatie over het Windows PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Een onderbrekingspunt instellen en uitschakelen

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

Met deze opdrachten wordt een nieuw onderbrekingspunt uitgeschakeld.

De eerste opdracht maakt gebruik van de cmdlet Set-PSBreakpoint om een onderbrekingspunt te maken op de variabele naam in het Sample.ps1 script. Vervolgens wordt het onderbrekingspuntobject opgeslagen in de variabele $B.

De tweede opdracht maakt gebruik van de cmdlet Disable-PSBreakpoint om het nieuwe onderbrekingspunt uit te schakelen. Er wordt een pijplijnoperator (|) gebruikt om het onderbrekingspuntobject in $B te verzenden naar de cmdlet disable-PSBreakpoint .

Als gevolg van deze opdracht is de waarde van de eigenschap Ingeschakeld van het onderbrekingspuntobject in $B Onwaar.

Voorbeeld 2: Een onderbrekingspunt uitschakelen

PS C:\> Disable-PSBreakpoint -Id 0

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

Voorbeeld 3: Een uitgeschakeld onderbrekingspunt maken

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

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

Hierbij wordt de cmdlet Disable-PSBreakpoint 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. In dit geval, omdat Set-PSBreakpoint een onderbrekingspuntobject genereert, kan het worden gebruikt als de waarde van de onderbrekingspuntparameter.

Met de tweede opdracht wordt het onderbrekingspuntobject weergegeven in de waarde van de $B variabele.

Voorbeeld 4: Alle onderbrekingspunten in de huidige console uitschakelen

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

Met deze opdracht worden alle onderbrekingspunten in de huidige console uitgeschakeld. U kunt deze opdracht verkorten als: "gbp | dbp'.

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

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 geeft u een matrix van id's of variabelen die de onderbrekingspunt-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 het item aangeeft waarmee u werkt. 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 Disable-PSBreakpoint.

Uitvoerwaarden

None or System.Management.Automation.Breakpoint

Wanneer u de parameter PassThru gebruikt, retourneert Disable-PSBreakpoint een object dat het uitgeschakelde onderbrekingspunt vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.