Debug-Process
Yerel bilgisayarda çalışan bir veya daha fazla işlemin hatalarını ayıklar.
Sözdizimi
Name EnterprisePublishing
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
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.
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
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.
Parametre özellikleri
| Tür: | Int32[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PID, ProcessId |
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 |
-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.
Parametre özellikleri
| Tür: | Process[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InputObject
| Position: | Named |
| 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 |
-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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | İşlemAdı |
Parametre kümeleri
Name
| 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 |
-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
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.
