Debug-Process

Başvuru

Modül:: Microsoft.PowerShell.Management

Yerel bilgisayarda çalışan bir veya daha fazla işlemin hatalarını ayıklar.

Sözdizimi

Debug-Process
     [-Name] <String[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Process
     [-Id] <Int32[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Process
     -InputObject <Process[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Debug-Process cmdlet'i yerel bilgisayardaki bir veya daha fazla çalışan işleme hata ayıklayıcı ekler. İşlemleri işlem adına veya işlem kimliğine (PID) göre belirtebilir veya işlem nesnelerini bu cmdlet'e yöneltebilirsiniz.

Bu cmdlet, işlem için kaydedilen hata ayıklayıcıyı ekler. Bu cmdlet'i kullanmadan önce bir hata ayıklayıcının yüklendiğini ve yapılandırıldığını doğrulayın.

Örnekler

Örnek 1: Bilgisayardaki bir işleme hata ayıklayıcı ekleme

Debug-Process -Name powershell

Bu komut, bilgisayardaki PowerShell işlemine bir hata ayıklayıcısı ekler.

Örnek 2: Belirtilen dizeyle başlayan tüm işlemlere hata ayıklayıcı ekleme

Debug-Process -Name note*

Bu komut, noteile başlayan adları olan tüm işlemlere bir hata ayıklayıcı ekler.

Örnek 3: Birden çok işleme hata ayıklayıcı ekleme

Debug-Process "Winlogon", "Explorer", "Outlook"

Bu komut Winlogon, Explorer ve Outlook işlemlerine hata ayıklayıcı eklemeye çalışır. Winlogon korumalı bir işlemdir. Winlogon'da hata ayıklamak için komutunu yönetici olarak çalıştırmanız gerekir.

Örnek 4: Birden çok işlem kimliklerine hata ayıklayıcı ekleme

Debug-Process -Id 1132, 2028

Bu komut, işlem kimlikleri 1132 ve 2028 olan işlemlere bir hata ayıklayıcı ekler.

Örnek 5: Bir işlem elde etmek ve ardından bir hata ayıklayıcı bağlamak için Get-Process kullanın.

Get-Process powershell | Debug-Process

Bu komut, bilgisayardaki PowerShell işlemlerine bir hata ayıklayıcısı ekler. Get-Process cmdlet'ini kullanarak PowerShell işlemlerini bilgisayara alır ve işlemleri | cmdlet'ine göndermek için bir işlem hattı işleci (Debug-Process) kullanır.

Belirli bir PowerShell işlemini belirtmek için Get-Process parametresini kullanın.

Örnek 6: Yerel bilgisayardaki geçerli işleme hata ayıklayıcı ekleme

Debug-Process -Id $PID

Bu komut, bilgisayardaki geçerli PowerShell işlemlerine bir hata ayıklayıcısı ekler.

komutu, geçerli PowerShell işleminin işlem kimliğini içeren $PID otomatik değişkenini kullanır. Ardından işlem kimliğini | cmdlet'ine göndermek için işlem hattı işlecini (Debug-Process) kullanır.

$PID otomatik değişkeni hakkında daha fazla bilgi için bkz. about_Automatic_Variables.

Örnek 7: InputObject parametresini kullanan bir işleme hata ayıklayıcı ekleme

$P = Get-Process powershell
Debug-Process -InputObject $P

Bu komut, yerel bilgisayardaki PowerShell işlemlerine bir hata ayıklayıcı ekler.

İlk komut, PowerShell işlemlerini bilgisayara almak için Get-Process cmdlet'ini kullanır. Sonuçta elde edilen işlem nesnesini $Padlı değişkene kaydeder.

İkinci komut, değişkeninde işlem nesnesini göndermek için Debug-Process cmdlet'in $P parametresini kullanır.

Parametreler

-Confirm

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

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Id

Hata ayıklanacak işlemlerin işlem kimliklerini belirtir. ID'si parametre adı isteğe bağlı.

Bir işlemin işlem kimliğini bulmak için Get-Processyazın.

Tür:	Int32[]
Diğer adlar:	PID, ProcessId
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-InputObject

Hata ayıklanacak işlemleri temsil eden işlem nesnelerini belirtir. İşlem nesnelerini içeren bir değişken veya Get-Process cmdlet'i gibi işlem nesnelerini alan bir komut girin. Ayrıca, işlem nesnelerini bu cmdlet'e de yöneltebilirsiniz.

Tür:	Process[]
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

Hata ayıklanacak işlemlerin adlarını belirtir. Aynı ada sahip birden fazla işlem varsa, bu cmdlet bu ada sahip tüm işlemlere bir hata ayıklayıcı ekler. Adı parametresi isteğe bağlıdır.

Tür:	String[]
Diğer adlar:	ProcessName
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-WhatIf

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

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

Int32

Bir işlem kimliğini bu cmdlet'e yöneltebilirsiniz.

Process

Bir işlem nesnesini bu cmdlet'e yöneltebilirsiniz.

String

Bir işlem adını bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

Bu cmdlet, Windows Yönetim Araçları (WMI) Win32_Process sınıfının AttachDebugger yöntemini kullanır. Bu yöntem hakkında daha fazla bilgi için Microsoft Learn'de AttachDebugger yöntemi bölümüne bakın.

Aracılığıyla paylaş