Disable-PSBreakpoint

Geçerli konsoldaki kesme noktalarını devre dışı bırakır.

Syntax

Breakpoint (Varsayılan)

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

Id

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

Description

Disable-PSBreakpoint cmdlet'i kesme noktalarını devre dışı bırakır ve bu da betik çalıştırıldığında isabet almamalarını sağlar. Tüm kesme noktalarını devre dışı bırakmak için kullanabilir veya kesme noktası nesneleri veya kesme noktası kimlikleri göndererek kesme noktaları belirtebilirsiniz.

Teknik olarak, bu cmdlet bir kesme noktası nesnesinin Enabled özelliğinin değerini False olarak değiştirir. Kesme noktasını yeniden etkinleştirmek için Enable-PSBreakpoint cmdlet'ini kullanın. Kesme noktaları, Set-PSBreakpoint cmdlet'ini kullanarak oluşturduğunuzda varsayılan olarak etkinleştirilir.

Kesme noktası, betikteki yönergeleri inceleyebilmeniz için yürütmenin geçici olarak durduğu bir noktadır. Disable-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 about_Debuggers bakın.

Örnekler

Örnek 1: Kesme noktası ayarlama ve devre dışı bırakma

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Bu komutlar yeni oluşturulan kesme noktasını devre dışı bırakır.

İlk komut, Sample.ps1 betiğindeki Name değişkeninde bir kesme noktası oluşturmak için Set-PSBreakpoint cmdlet'ini kullanır. Ardından kesme noktası nesnesini $B değişkenine kaydeder.

İkinci komut, yeni kesme noktasını devre dışı bırakmak için Disable-PSBreakpoint cmdlet'ini kullanır. $B'deki kesme noktası nesnesini Disable-PSBreakpoint cmdlet'ine göndermek için işlem hattı işlecini (|) kullanır.

Bu komutun sonucu olarak, $B kesme noktası nesnesinin Enabled özelliğinin değeri False'tur.

Örnek 2: Kesme noktasını devre dışı bırakma

PS C:\> Disable-PSBreakpoint -Id 0

Bu komut kesme noktası kimliği 0 olan kesme noktasını devre dışı bırakır.

Örnek 3: Devre dışı kesme noktası oluşturma

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Bu komut, siz etkinleştirene kadar devre dışı bırakılan yeni bir kesme noktası oluşturur.

Kesme noktasını devre dışı bırakmak için disable-PSBreakpoint cmdlet'ini kullanır. Kesme Noktası parametresinin değeri, yeni bir kesme noktası ayarlayan, kesme noktası nesnesi oluşturan ve nesneyi $B değişkenine kaydeden bir Set-PSBreakpoint komutudur.

Nesneleri değerleri olarak alan cmdlet parametreleri, nesneyi içeren bir değişkeni veya nesneyi alan veya oluşturan bir komutu kabul edebilir. Bu durumda, Set-PSBreakpoint bir kesme noktası nesnesi oluşturduğundan, Kesme Noktası parametresinin değeri olarak kullanılabilir.

İkinci komut, kesme noktası nesnesini $B değişkeninin değerinde görüntüler.

Örnek 4: Geçerli konsoldaki tüm kesme noktalarını devre dışı bırakma

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Bu komut geçerli konsoldaki tüm kesme noktalarını devre dışı bırakır. Bu komutu şu şekilde kısaltabilirsiniz: "gbp | dbp".

Parametreler

-Breakpoint

Devre dışı bırakacak kesme noktalarını belirtir. Kesme noktası nesneleri içeren bir değişken veya Get-PSBreakpoint komutu gibi kesme noktası nesnelerini alan bir komut girin. Kesme noktası nesnelerini Disable-PSBreakpoint cmdlet'ine de yöneltebilirsiniz.

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

Belirtilen kesme noktası kimlikleriyle kesme noktalarını devre dışı bırakır. Kimlikleri veya kimlikleri içeren bir değişken girin. Disable-PSBreakpointkimlikleri kanala ekleyemezsiniz.

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

Etkin kesme noktaları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

-WhatIf

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

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 disable-PSBreakpointyöneltebilirsiniz.

Çıkışlar

None or System.Management.Automation.Breakpoint

PassThru parametresini kullandığınızda, Disable-PSBreakpoint devre dışı bırakılan kesme noktasını temsil eden bir nesne döndürür. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.