Share via

Get-PSBreakpoint

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

Geçerli oturumda ayarlanan kesme noktalarını alır.

Syntax

Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <Int32[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Description

cmdlet'i Get-PSBreakPoint geçerli oturumda ayarlanan kesme noktalarını alır. Belirli kesme noktalarını almak için cmdlet parametrelerini kullanabilirsiniz.

Kesme noktası, komut veya betikte, yönergeleri inceleyebilmeniz için yürütmenin geçici olarak durduğu bir noktadır. Get-PSBreakpoint , PowerShell betiklerinde ve komutlarında 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 betikler ve işlevler için tüm kesme noktalarını alma

Bu komut, geçerli oturumdaki tüm betiklerde ve işlevlerde ayarlanan tüm kesme noktalarını alır.

Get-PSBreakpoint

Örnek 2: Kimlikle kesme noktalarını alma

Bu komut kesme noktası kimliği 2 olan kesme noktasını alır.

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Örnek 3: Kimliği 'Get-PSBreakpoint'e yöneltme

Bu komutlar, kesme noktası kimliğini adresine getirerek kesme noktası alma işlemini Get-PSBreakpointgösterir.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

cmdlet betiğindeki Set-PSBreakpoint Increment işlevinde Sample.ps1 bir kesme noktası oluşturur ve kesme noktası nesnesini değişkene $B kaydeder. Değişkendeki $B kesme noktası nesnesinin Id özelliği, kesme noktası bilgilerini görüntülemek için Get-PSBreakpoint cmdlet'ine yöneltilir.

Örnek 4: Belirtilen betik dosyalarındaki kesme noktalarını alma

Bu komut ve SupportScript.ps1 dosyalarındaki tüm kesme noktalarını Sample.ps1 alır.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Bu komut, diğer betiklerde veya oturumdaki işlevlerde ayarlanabilecek diğer kesme noktalarını almaz.

Örnek 5: Belirtilen cmdlet'lerde kesme noktalarını alma

Bu komut, dosyada Read-Host veya Write-HostSample.ps1 komutlarında ayarlanan tüm Komut kesme noktalarını alır.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Örnek 6: Belirtilen dosyada Komut kesme noktalarını alma

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Bu komut, Sample.ps1 dosyasındaki tüm Komut kesme noktalarını alır.

Örnek 7: Değişkene göre kesme noktalarını alma

Bu komut, geçerli oturumdaki $Index ve $Swap değişkenlerinde ayarlanan kesme noktalarını alır.

Get-PSBreakpoint -Variable "Index, Swap"

Örnek 8: Dosyadaki tüm Satır ve Değişken kesme noktalarını alma

Bu komut betikteki Sample.ps1 tüm satır ve değişken kesme noktalarını alır.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Örnek 9: Belirli bir çalışma alanında ayarlanan kesme noktalarını alma

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. Ardından değişkendeki $breakpoint kesme noktasını inceleyebilirsiniz.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Parametreler

-Command

Belirtilen komut adlarında ayarlanan bir komut kesme noktası dizisini belirtir. Cmdlet veya işlev adı gibi komut adlarını girin.

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

-Id

Bu cmdlet'in aldığı kesme noktası kimliklerini belirtir. Kimlikleri virgülle ayrılmış bir listeye girin. Kesme noktası kimliklerini adresine Get-PSBreakpointde yöneltebilirsiniz.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Kesme noktalarını içeren bir betik dizisi belirtir. Bir veya daha fazla betik dosyasının yolunu (isteğe bağlı) ve adlarını girin. Yolu atlarsanız, varsayılan konum geçerli dizindir.

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

-Type

Bu cmdlet'in aldığı kesme noktası türleri dizisini belirtir. Bir veya daha fazla tür girin. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Satır
  • Command
  • Değişken

Kesme noktası türlerini de öğesine yöneltebilirsiniz Get-PSBreakPoint.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Variable

Belirtilen değişken adlarında ayarlanan değişken kesme noktaları dizisini belirtir. Değişken adlarını dolar işareti olmadan girin.

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

Girişler

Int32

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

BreakpointType

Kesme noktası türlerini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Bu cmdlet, oturumdaki kesme noktalarını temsil eden nesneleri döndürür.

Notlar

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

  • Tüm platformlar:
    • gbp