Aracılığıyla paylaş

Disable-PSBreakpoint

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

cmdlet'i Disable-PSBreakpoint kesme noktalarını devre dışı bırakır ve bu da betik çalıştırıldığında isabet edilmemelerini 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 kesme noktası nesnesinin Enabled özelliğinin değerini False olarak değiştirir. Kesme noktasını yeniden etkinleştirmek için cmdlet'ini Enable-PSBreakpoint kullanın. Kesme noktaları, cmdlet'ini Set-PSBreakpoint 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 bkz. about_Debuggers.

Örnekler

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

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

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

cmdlet'i Set-PSBreakpoint betikteki $Name değişkende Sample.ps1 bir kesme noktası oluşturur ve kesme noktası nesnesini değişkene $B kaydeder. cmdlet'i Disable-PSBreakpoint yeni kesme noktasını devre dışı bırakır. kesme noktası nesnesini cmdlet'ine $B göndermek için Disable-PSBreakpoint bir işlem hattı işleci (|) kullanır.

Bu komutun sonucu olarak içindeki kesme noktası nesnesinin $BEnabled özelliğinin değeri False'tur.

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

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

Disable-PSBreakpoint -Id 0

Örnek 3: Devre dışı bırakılmış kesme noktasını İçerik Oluşturucu

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

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

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

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, kesme noktası nesnesi oluşturduğundan Set-PSBreakpoint Kesme Noktası parametresinin değeri olarak kullanılabilir.

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

Bu komut geçerli konsoldaki tüm kesme noktalarını devre dışı bırakır.

`Get-PSBreakpoint` | Disable-PSBreakpoint

Parametreler

-Breakpoint

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

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Belirtilen kesme noktası kimlikleriyle kesme noktalarını devre dışı bırakır. Kimlikleri veya kimlikleri içeren bir değişken girin. Kimlikleri adresine Disable-PSBreakpointyöneltemezsiniz.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Etkin kesme noktalarını temsil eden bir nesne döndürür. Varsayılan olarak bu cmdlet herhangi bir çıktı üretmez.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

Breakpoint

Kesme noktası nesnesini öğesine 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.