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[]>
       [-Runspace <Runspace>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

cmdlet'i Disable-PSBreakpoint kesme noktalarını devre dışı bırakır ve 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 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 betikteki Set-PSBreakpointSample.ps1 değişkende $Name 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 Enabled özelliğinin değeri False'tur.$B

Ö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ışı kesme noktası oluşturma

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 kesme noktası ayarlayan, kesme noktası nesnesi oluşturan ve nesneyi değişkene $B kaydeden bir Set-PSBreakpoint 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, Set-PSBreakpoint kesme noktası nesnesi oluşturduğundan 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

Örnek 5: Çalışma alanında kesme noktasını devre dışı bırakma

Bu örnekte, bir iş başlatılır ve bir kesme noktası çalıştırıldığında Set-PSBreakPoint kesecek şekilde ayarlanır. Runspace bir değişkende depolanır ve Runspace parametresiyle komutuna geçirilirGet-PSBreakPoint. çıkışı Get-PSBreakPoint , çalışma alanında kesme noktasını devre dışı bırakmak için öğesine yöneltilir Disable-PSBreakpoint .

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

Parametreler

-Breakpoint

Devre dışı bırakacak kesme noktalarını belirtir. Kesme noktası nesneleri 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 yöneltemezsiniz Disable-PSBreakpoint.

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 çıkış oluşturmaz.

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

-Runspace

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

Bu parametre PowerShell 7.2'ye eklendi.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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 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 devre dışı bırakılan kesme noktasını temsil eden bir kesme noktası nesnesi döndürür.

Notlar

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

  • Tüm platformlar:
    • dbp