Enable-PSBreakpoint

Modül:
Microsoft.PowerShell.Utility Module

Geçerli konsoldaki kesme noktalarını etkinleştirir.

Syntax

Breakpoint (Varsayılan) 

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

Id 

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

Description

Enable-PSBreakpoint cmdlet'i devre dışı bırakılan kesme noktalarını yeniden etkinleştirir. Kesme noktası nesneleri veya kimlikleri sağlayarak tüm kesme noktalarını veya belirli kesme noktalarını etkinleştirmek için kullanabilirsiniz.

Kesme noktası, betiğin durumunu inceleyebilmeniz için yürütmenin geçici olarak durduğu bir betik noktasıdır. Yeni oluşturulan kesme noktaları otomatik olarak etkinleştirilir, ancak Disable-PSBreakpointkullanılarak devre dışı bırakılabilir.

Teknik olarak, bu cmdlet kesme noktası nesnesinin Enabled özelliğinin değerini Trueolarak değiştirir.

Enable-PSBreakpoint, PowerShell betiklerinde hata ayıklamak için tasarlanmış çeşitli cmdlet'lerden biridir. PowerShell hata ayıklayıcısı hakkında daha fazla bilgi için bkz. about_Debuggers.

Örnekler

Örnek 1: Tüm kesme noktalarını etkinleştirme

Bu örnek geçerli oturumdaki tüm kesme noktalarını etkinleştirir.

Get-PSBreakpoint | Enable-PSBreakpoint

Diğer adlar kullanılarak, bu örnek gbp | ebpolarak kısaltılabilir.

Örnek 2: Kesme noktalarını kimliklerine göre etkinleştirme

Bu örnek, kesme noktası kimliklerini kullanarak birden çok kesme noktası sağlar.

Enable-PSBreakpoint -Id 0, 1, 5

Örnek 3: Devre dışı bırakılmış kesme noktasını etkinleştirme

Bu örnek, devre dışı bırakılmış bir kesme noktasını yeniden etkinleştirir.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint, kesme noktası nesnesini değişkenine kaydeden Sample.ps1 betiğindeki $B değişkeninde bir kesme noktası oluşturur. PassThru parametresi, kesme noktasının Etkin özelliğinin falsedeğerini görüntüler.

Enable-PSBreakpoint kesme noktasını yeniden etkinleştirir. PassThru parametresini kullanarak Enabled özelliğinin değerinin Trueolduğunu görüyoruz.

Örnek 4: Değişken kullanarak kesme noktalarını etkinleştirme

Bu örnek, kesme noktası nesnelerini kullanarak bir dizi kesme noktası sağlar.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint kesme noktalarını alır ve $B değişkenine kaydeder. Kesme Noktası parametresini kullanarak Enable-PSBreakpoint kesme noktalarını etkinleştirir.

Bu örnek, Enable-PSBreakpoint -Id 3, 5çalıştırmaya eşdeğerdir.

Örnek 5: Bir çalışma alanında kesme noktasını etkinleştirme

Bu örnekte, kesme noktası ile bir iş başlatılır ve sonra devre dışı bırakılır. Runspace bir değişkende depolanır ve Get-PSBreakpoint parametresiyle komutuna geçirilir. Get-PSBreakpoint çıkışı, çalışma alanında kesme noktasını etkinleştirmek için Enable-PSBreakpoint yöneltilir.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Parametreler

-Breakpoint

Etkinleştirileceği kesme noktalarını belirtir. kesme noktaları içeren bir değişken veya Get-PSBreakpointgibi kesme noktası nesnelerini alan bir komut sağlayın. Kesme noktası nesnelerini Enable-PSBreakpoint'a yönlendirebilirsiniz.

Parametre özellikleri

Tür:

Breakpoint[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Breakpoint
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Id

Etkinleştirileceği kesme noktalarının kimliğini numaralarını belirtir. Varsayılan değer tüm kesme noktalarıdır. Kimliğini sayıya veya değişkene göre sağlayın. Kimlik numaralarını Enable-PSBreakpoint. Kesme noktasının kimliği bulmak için Get-PSBreakpoint cmdlet'ini kullanın.

Parametre özellikleri

Tür:

Int32[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Id
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-PassThru

Etkinleştirilmekte olan kesme noktasını temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Runspace

Belirtilen çalışma alanında kesme noktalarıyla etkileşim kurabilmeniz için bir Runspace nesnesinin kimliğini belirtir.

Bu parametre PowerShell 7.2'ye eklendi.

Parametre özellikleri

Tür:Runspace
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:RunspaceId

Parametre kümeleri

Id
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

Breakpoint

Kesme noktası nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

Breakpoint

PassThru parametresini kullandığınızda, bu cmdlet etkin kesme noktasını temsil eden bir kesme noktası nesnesi döndürür.

Notlar

PowerShell, Enable-PSBreakpointiçin aşağıdaki diğer adları içerir:

  • Tüm platformlar:

    • ebp

  • Zaten etkinleştirilmiş bir kesme noktasını etkinleştirmeye çalışırsanız Enable-PSBreakpoint cmdlet'i hata oluşturmaz. Bu nedenle, yalnızca birkaçı devre dışı bırakıldığında bile tüm kesme noktalarını hatasız olarak etkinleştirebilirsiniz.

  • Kesme noktaları, Set-PSBreakpoint cmdlet'ini kullanarak oluşturduğunuzda etkinleştirilir. Yeni oluşturulan kesme noktalarını etkinleştirmeniz gerekmez.