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 deze 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 Enable-PSBreakpoint cmdlet. Onderbrekingspunten zijn 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 Foutopsporingsprogramma van PowerShell.

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 voor 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 $B onwaar.

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 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 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 er in Set-PSBreakpoint dit geval 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

Voorbeeld 5: Een onderbrekingspunt in een runspace uitschakelen

In dit voorbeeld wordt een taak gestart en wordt een onderbrekingspunt ingesteld op einde wanneer de Set-PSBreakPoint taak wordt uitgevoerd. De runspace wordt opgeslagen in een variabele en doorgegeven aan de Get-PSBreakPoint opdracht met de parameter Runspace . De uitvoer van Get-PSBreakPoint wordt doorgesluisd om het onderbrekingspunt in de runspace uit te Disable-PSBreakpoint schakelen.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

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

Type:Breakpoint[]
Position:0
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Je kunt geen id's doorsluisen naar Disable-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
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
Required:False
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.

Deze parameter is toegevoegd in PowerShell 7.2.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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

PowerShell bevat de volgende aliassen voor Disable-PSBreakpoint:

  • Alle platforms:
    • dbp