Debug-Process
A helyi számítógépen futó egy vagy több folyamat hibakeresése.
Syntax
Name (Alapértelmezett)
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Debug-Process parancsmag egy hibakeresőt csatol egy vagy több helyi számítógépen futó folyamathoz. A folyamatokat a folyamatnév vagy a folyamatazonosító (PID) alapján adhatja meg, vagy a parancsmaghoz folyamatobjektumokat is csövezhet.
Ez a parancsmag csatolja a folyamathoz jelenleg regisztrált hibakeresőt. A parancsmag használata előtt ellenőrizze, hogy a hibakereső le lett-e töltve és megfelelően van-e konfigurálva.
Példák
1. példa: Hibakereső csatolása egy folyamathoz a számítógépen
PS C:\> Debug-Process -Name "Windows Powershell"
Ez a parancs egy hibakeresőt csatol a windowsos PowerShell-folyamathoz a számítógépen.
2. példa: Hibakereső csatolása a megadott sztringgel kezdődő összes folyamathoz
PS C:\> Debug-Process -Name "SQL*"
Ez a parancs egy hibakeresőt csatol minden olyan folyamathoz, amelynek neve SQL-vel kezdődik.
3. példa: Hibakereső csatolása több folyamathoz
PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"
Ez a parancs egy hibakeresőt csatol a Winlogon-, Explorer- és Outlook-folyamatokhoz.
4. példa: Hibakereső csatolása több folyamatazonosítóhoz
PS C:\> Debug-Process -Id 1132, 2028
Ez a parancs egy hibakeresőt csatol azokhoz a folyamatokhoz, amelyek 1132- és 2028-ás folyamatazonosítóval rendelkeznek.
5. példa: Folyamat lekérése Get-Process használatával, majd hibakereső csatolása hozzá
PS C:\> Get-Process "Windows PowerShell" | Debug-Process
Ez a parancs egy hibakeresőt csatol a windowsos PowerShell-folyamatokhoz a számítógépen. A Get-Process parancsmaggal lekéri a Windows PowerShell-folyamatokat a számítógépen, és egy folyamatkezelő (|) használatával küldi el a folyamatokat a Hibakeresési folyamat parancsmagnak.
Egy adott PowerShell-folyamat megadásához használja a Get-Processazonosítóparaméterét.
6. példa: Hibakereső csatolása egy aktuális folyamathoz a helyi számítógépen
PS C:\> $PID | Debug-Process
Ez a parancs egy hibakeresőt csatol a számítógépen futó aktuális Windows PowerShell-folyamatokhoz.
A parancs a $PID automatikus változót használja, amely az aktuális Windows PowerShell-folyamat folyamatazonosítóját tartalmazza. Ezután egy folyamatkezelővel (|) küldi el a folyamatazonosítót a Hibakeresési folyamat parancsmagnak.
Az $PID automatikus változóval kapcsolatos további információkért lásd: about_Automatic_Variables.
7. példa: Hibakereső csatolása a megadott folyamathoz több számítógépen
PS C:\> Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process
Ez a parancs egy hibakeresőt csatol a MyApp-folyamatokhoz a Server01 és a Server02 számítógépeken.
A parancs a Get-Process parancsmaggal szerzi be a MyApp-folyamatokat a Server01 és Server02 számítógépeken. Folyamatkezelő használatával küldi el a folyamatokat a Debug-Process parancsmagnak, amely a hibakeresőket csatolja.
8. példa: Hibakereső csatolása az InputObject paramétert használó folyamathoz
PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> Debug-Process -InputObject $P
Ez a parancs egy hibakeresőt csatol a helyi számítógépen található Windows PowerShell-folyamatokhoz.
Az első parancs a Get-Process parancsmagot használja a Windows PowerShell-folyamatok számítógépen való lekéréséhez. Menti az eredményként kapott folyamatobjektumot a $P nevű változóban.
A második parancs a Debug-Process parancsmag InputObject paraméterével küldi el a folyamatobjektumot a $P változóban.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Id
Megadja a hibakereséshez használható folyamatok folyamatazonosítóit. A azonosító paraméter neve nem kötelező.
Egy folyamat folyamatazonosítójának megkereséséhez írja be a Get-Process.
Paramétertulajdonságok
| Típus: | Int32[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | folyamatazonosító, ProcessId |
Paraméterkészletek
Id
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Megadja a hibakereséshez használt folyamatobjektumokat. Adjon meg egy változót, amely tartalmazza a folyamatobjektumokat, vagy egy olyan parancsot, amely lekéri a folyamatobjektumokat, például a Get-Process parancsmagot. A parancsmaghoz folyamatobjektumokat is csövezhet.
Paramétertulajdonságok
| Típus: | Process[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InputObject
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja a hibakereséshez használt folyamatok nevét. Ha több, azonos nevű folyamat is létezik, ez a parancsmag egy hibakeresőt csatol az összes ilyen nevű folyamathoz. A Név paraméter megadása nem kötelező.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | ProcessName |
Paraméterkészletek
Name
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
System.Int32, System.Diagnostics.Process, System.String
Ehhez a parancsmaghoz folyamatazonosítót (Int32), folyamatobjektumot (System.Diagnostics.Process) vagy folyamatnevet (sztringet) helyezhet el.
Kimenetek
None
Ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
- Ez a parancsmag a Windows Management Instrumentation (WMI) Win32_Process osztály AttachDebugger metódusát használja. A metódusról további információt az MSDN-kódtárban
AttachDebugger metódusában talál.