Stop-Process
Beendet ausgeführte Prozesse.
Syntax
Stop-Process
[-Id] <Int32[]>
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Process
-Name <String[]>
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Process
[-InputObject] <Process[]>
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Stop-Process
Cmdlet beendet mindestens einen ausgeführten Prozess. Sie können einen Prozess nach Prozessname oder Prozess-ID (PID) angeben oder ein Prozessobjekt an Stop-Process
übergeben. Stop-Process
funktioniert nur bei Prozessen, die auf dem lokalen Computer ausgeführt werden.
Unter Windows Vista und höheren Versionen des Windows-Betriebssystems müssen Sie PowerShell mithilfe der Option "Als Administrator ausführen" starten, um einen Prozess zu beenden, der nicht dem aktuellen Benutzer gehört. Außerdem werden Sie nicht zur Bestätigung aufgefordert, es sei denn, Sie geben den Parameter Confirm an.
Beispiele
Beispiel 1: Beenden aller Instanzen eines Prozesses
PS C:\> Stop-Process -Name "notepad"
Mit diesem Befehl werden alle Instanzen des Notepad-Prozesses (Editor) auf dem Computer beendet. Jede Instanz von Editor wird in einem eigenen Prozess ausgeführt. Er verwendet den Parameter Name , um die Prozesse anzugeben, die alle denselben Namen haben. Wenn Sie den Id-Parameter verwenden würden, um dieselben Prozesse zu beenden, müssten Sie die Prozess-IDs jeder Instanz von Editor auflisten.
Beispiel 2: Beenden einer bestimmten Instanz eines Prozesses
PS C:\> Stop-Process -Id 3952 -Confirm -PassThru
Confirm
Are you sure you want to perform this action?
Performing operation "Stop-Process" on Target "notepad (3952)".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help
(default is "Y"):y
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
41 2 996 3212 31 3952 notepad
Mit diesem Befehl wird eine bestimmte Instanz des Notepad-Prozesses beendet. Der Prozess wird mit der Prozess-ID 3952 angegeben. Der Parameter Confirm leitet PowerShell an, um Sie aufzufordern, bevor der Prozess beendet wird. Da die Eingabeaufforderung zusätzlich zur ID den Prozessnamen enthält, ist dies die bewährte Methode.
Der PassThru-Parameter übergibt das Prozessobjekt an den Formatierer für die Anzeige. Ohne diesen Parameter wäre nach einem Stop-Process
Befehl keine Anzeige vorhanden.
Beispiel 3: Beenden eines Prozesses und Erkennen, dass er beendet wurde
calc
$p = Get-Process -Name "calc"
Stop-Process -InputObject $p
Get-Process | Where-Object {$_.HasExited}
Diese Reihe von Befehlen startet und beendet den Calc
Prozess und erkennt dann Prozesse, die beendet wurden.
Der erste Befehl startet eine Instanz des Rechners.
Der zweite Befehl verwendet Get-Process
ein Objekt, das den Calc
Prozess darstellt, und speichert es dann in der $p
Variablen.
Der dritte Befehl beendet den Calc
Prozess. Es verwendet den InputObject-Parameter , um das Objekt an Stop-Process
.
Mit dem letzten Befehl werden alle zuvor auf dem Computer ausgeführten Prozesse abgerufen, die nun beendet sind. Es wird verwendet Get-Process
, um alle Prozesse auf dem Computer abzurufen. Der Pipelineoperator (|
) übergibt die Ergebnisse an das Where-Object
Cmdlet, das die Ergebnisse auswählt, bei denen der Wert der HasExited-Eigenschaft $True ist. HasExited ist nur eine Eigenschaft von Prozessobjekten. Um alle Eigenschaften zu finden, geben Sie Get-Process | Get-Member
.
Beispiel 4: Beenden eines Prozesses, der nicht dem aktuellen Benutzer gehört
PS> Get-Process -Name "lsass" | Stop-Process
Stop-Process : Cannot stop process 'lsass (596)' because of the following error: Access is denied
At line:1 char:34
+ Get-Process -Name "lsass" | Stop-Process <<<<
[ADMIN]: PS> Get-Process -Name "lsass" | Stop-Process
Warning!
Are you sure you want to perform this action?
Performing operation 'Stop-Process' on Target 'lsass(596)'
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
[ADMIN]: PS> Get-Process -Name "lsass" | Stop-Process -Force
[ADMIN]: PS>
Diese Befehle zeigen die Auswirkung der Verwendung von Force zum Beenden eines Prozesses, der nicht dem Benutzer gehört.
Der erste Befehl verwendet Get-Process
, um den Lsass-Prozess abzurufen. Ein Pipelineoperator sendet den Prozess, um Stop-Process
ihn zu beenden. Wie in der Beispielausgabe gezeigt, schlägt der erste Befehl mit einer Meldung "Zugriff verweigert" fehl, da dieser Vorgang nur von einem Mitglied der Administratorgruppe auf dem Computer beendet werden kann.
Wenn PowerShell mithilfe der Option "Als Administrator ausführen" geöffnet wird und der Befehl wiederholt wird, werden Sie von PowerShell zur Bestätigung aufgefordert.
Der zweite Befehl gibt Force an, um die Eingabeaufforderung zu unterdrücken. Der Prozess wird daher ohne Bestätigung beendet.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Force
Beendet die angegebenen Prozesse, ohne zum Bestätigen aufzufordern. Fordert standardmäßig zur Bestätigung auf, bevor ein Prozess beendet wird, Stop-Process
der nicht dem aktuellen Benutzer gehört.
Um den Besitzer eines Prozesses zu finden, verwenden Sie das Get-CimInstance
Cmdlet, um ein Win32_Process-Objekt abzurufen, das den Prozess darstellt, und verwenden Sie dann die GetOwner-Methode des Objekts.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Id
Gibt die Prozess-IDs der zu beendenden Prozesse an. Wenn Sie mehrere IDs angeben, trennen Sie diese durch Kommas. Um die PID eines Prozesses zu finden, geben Sie folgendes ein Get-Process
.
Typ: | Int32[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt die zu beendenden Prozessobjekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.
Typ: | Process[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt die Prozessnamen der zu beendenden Prozesse an. Sie können mehrere Prozessnamen eingeben, durch Kommas getrennt oder Mithalterzeichen verwenden.
Typ: | String[] |
Aliase: | ProcessName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | True |
-PassThru
Gibt ein Objekt zurück, das den Prozess darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können ein Prozessobjekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.
Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein Process-Objekt zurück, das den beendeten Prozess darstellt.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Stop-Process
:
kill
spps
Sie können auch die Eigenschaften und Methoden der Windows-Verwaltungsinstrumentation (WMI) Win32_Process-Objekts in Windows PowerShell verwenden. Weitere Informationen finden Sie im
Get-CimInstance
WMI SDK.Beachten Sie beim Beenden von Prozessen, dass das Beenden eines Prozesses Prozess und Dienste beenden kann, die vom Prozess abhängen. Im Extremfall kann durch Beenden eines Prozesses sogar Windows beendet werden.