Disable-PSBreakpoint

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

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

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.

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.

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

Disable-PSBreakpoint -Id 0

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.

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

In dit voorbeeld wordt een taak gestart en wordt een onderbrekingspunt ingesteld op einde wanneer de Set-PSBreakpoint wordt uitgevoerd. De runspace wordt opgeslagen in een variabele en doorgegeven aan de opdracht Get-PSBreakpoint met de parameter Runspace. De uitvoer van Get-PSBreakpoint wordt doorgesluisd naar Disable-PSBreakpoint om het onderbrekingspunt in de runspace uit te 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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een onderbrekingspuntobject doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

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

PowerShell bevat de volgende aliassen voor Disable-PSBreakpoint:

• Alle platforms:
  • dbp