Remove-PSBreakpoint
Hiermee verwijdert u onderbrekingspunten uit de huidige console.
Syntax
Breakpoint (Standaard)
Remove-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Remove-PSBreakpoint
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Remove-PSBreakpoint verwijdert een onderbrekingspunt. Voer een onderbrekingspuntobject of een onderbrekingspunt-id in.
Wanneer u een onderbrekingspunt verwijdert, is het onderbrekingspuntobject niet meer beschikbaar of functioneel. Als u een onderbrekingspuntobject in een variabele hebt opgeslagen, bestaat de verwijzing nog steeds, maar werkt het onderbrekingspunt niet.
Remove-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: Alle onderbrekingspunten verwijderen
PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint
Met deze opdracht worden alle onderbrekingspunten in de huidige console verwijderd.
Voorbeeld 2: Een opgegeven onderbrekingspunt verwijderen
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint
Met deze opdracht wordt een onderbrekingspunt verwijderd.
De eerste opdracht maakt gebruik van de cmdlet Set-PSBreakpoint om een onderbrekingspunt te maken voor de variabele Naam in het Sample.ps1 script. Vervolgens wordt het onderbrekingspuntobject opgeslagen in de variabele $B.
De tweede opdracht gebruikt de cmdlet Remove-PSBreakpoint om het nieuwe onderbrekingspunt te verwijderen. Er wordt een pijplijnoperator (|) gebruikt om het onderbrekingspuntobject in de $B variabele te verzenden naar de cmdlet Remove-PSBreakpoint.
Als u het script uitvoert, wordt het als gevolg van deze opdracht uitgevoerd tot voltooiing zonder te stoppen. De cmdlet Get-PSBreakpoint retourneert dit onderbrekingspunt ook niet.
Voorbeeld 3: Een onderbrekingspunt verwijderen op id
PS C:\> Remove-PSBreakpoint -Id 2
Met deze opdracht wordt het onderbrekingspunt met onderbrekingspunt-id 2 verwijderd.
Voorbeeld 4: Een functie gebruiken om alle onderbrekingspunten te verwijderen
PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }
Met deze eenvoudige functie worden alle onderbrekingspunten in de huidige console verwijderd. De cmdlet Get-PSBreakpoint wordt gebruikt om de onderbrekingspunten op te halen. Vervolgens wordt een pijplijnoperator (|) gebruikt om de onderbrekingspunten te verzenden naar de cmdlet Remove-PSBreakpoint, waardoor ze worden verwijderd.
Als gevolg hiervan kunt u del-psb typen in plaats van de langere opdracht.
Als u de functie wilt opslaan, voegt u deze toe aan uw Windows PowerShell-profiel.
Parameters
-Breakpoint
Hiermee geeft u de onderbrekingspunten die moeten worden verwijderd. Voer een variabele in die onderbrekingspuntobjecten of een opdracht bevat waarmee onderbrekingspuntobjecten worden opgehaald, zoals een opdracht Get-PSBreakpoint. U kunt ook onderbrekingspuntobjecten naar Remove-PSBreakpoint.
Parametereigenschappen
| Type: | Breakpoint[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Breakpoint
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Id
Hiermee geeft u onderbrekingspunt-id's op waarvoor deze cmdlet onderbrekingspunten verwijdert.
Parametereigenschappen
| Type: | Int32[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
Id
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
Breakpoint
U kunt onderbrekingspuntobjecten naar Remove-PSBreakpoint.
Uitvoerwaarden
None
De cmdlet genereert geen uitvoer.