Disable-PSBreakpoint

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee worden de onderbrekingspunten in de huidige console uitgeschakeld.

Syntax

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

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

Description

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

Technisch gezien wijzigt deze cmdlet de waarde van de eigenschap Ingeschakeld van een onderbrekingspuntobject in False. Gebruik de Enable-PSBreakpoint cmdlet om een onderbrekingspunt opnieuw in te schakelen. 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_Debuggers voor 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 Set-PSBreakpoint cmdlet maakt een onderbrekingspunt op de $Name variabele in het Sample.ps1 script en slaat het onderbrekingspuntobject op in de $B variabele. Met Disable-PSBreakpoint de cmdlet wordt het nieuwe onderbrekingspunt uitgeschakeld. Er wordt een pijplijnoperator (|) gebruikt om het onderbrekingspuntobject naar $B de Disable-PSBreakpoint cmdlet te verzenden.

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

Voorbeeld 2: Een onderbrekingspunt uitschakelen

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

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 wordt gebruikt Disable-PSBreakpoint 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 in de $B variabele wordt opgeslagen.

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 er een onderbrekingspuntobject wordt gegenereerd, 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 bevat of een opdracht 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
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Hiermee worden de onderbrekingspunten met de opgegeven onderbrekingspunt-id's uitgeschakeld. Voer de id's of een variabele in die de id's bevat. Je kunt geen id's doorsluisen naar Disable-PSBreakpoint.

Type:	Int32[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Runspace

Hiermee geeft u de id van een Runspace-object op, zodat u kunt communiceren met onderbrekingspunten in de opgegeven runspace.

Type:	Runspace
Aliases:	RunspaceId
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

Breakpoint

U kunt een onderbrekingspuntobject doorsluisen naar Disable-PSBreakpoint.

Uitvoerwaarden

None or System.Management.Automation.Breakpoint

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