Stop-Process

Moduł:: Microsoft.PowerShell.Management Module

Zatrzymuje co najmniej jeden uruchomiony proces.

Składnia

Id (Domyślna)

Stop-Process
    [-Id] <Int32[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Name

Stop-Process
    -Name <String[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Stop-Process
    [-InputObject] <Process[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Stop-Process zatrzymuje co najmniej jeden uruchomiony proces. Proces można określić według nazwy procesu lub identyfikatora procesu (PID) lub przekazać obiekt procesu do Stop-Process. Stop-Process działa tylko w przypadku procesów uruchomionych na komputerze lokalnym.

W systemie Windows Vista i nowszych wersjach systemu operacyjnego Windows, aby zatrzymać proces, który nie jest własnością bieżącego użytkownika, należy uruchomić program PowerShell przy użyciu opcji Uruchom jako administrator. Ponadto nie zostanie wyświetlony monit o potwierdzenie, chyba że określisz parametr Potwierdź.

Przykłady

Przykład 1. Zatrzymanie wszystkich wystąpień procesu

Stop-Process -Name "notepad"

To polecenie zatrzymuje wszystkie wystąpienia procesu Notatnika na komputerze. Każde wystąpienie Notatnika jest uruchamiane we własnym procesie. Używa parametru Name w celu określenia procesów, z których wszystkie mają taką samą nazwę. Jeśli używasz parametru Id, aby zatrzymać te same procesy, musisz wyświetlić listę identyfikatorów procesów każdego wystąpienia Notatnika.

Przykład 2. Zatrzymanie określonego wystąpienia procesu

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

To polecenie zatrzymuje określone wystąpienie procesu Notatnika. Używa identyfikatora procesu 3952, aby zidentyfikować proces. Parametr Confirm przekierowuje program PowerShell w celu wyświetlenia monitu przed zatrzymanie procesu. Ponieważ monit zawiera nazwę procesu oprócz jego identyfikatora, jest to najlepsze rozwiązanie. Parametr PassThru przekazuje obiekt procesu do obiektu formatującego do wyświetlania. Bez tego parametru nie będzie wyświetlany po Stop-Process polecenia.

Przykład 3. Zatrzymanie procesu i wykrycie, że proces został zatrzymany

calc
$p = Get-Process -Name "calc"
Stop-Process -InputObject $p
Get-Process | Where-Object {$_.HasExited}

Ta seria poleceń uruchamia i zatrzymuje proces Calc, a następnie wykrywa procesy, które zostały zatrzymane.

Pierwsze polecenie uruchamia wystąpienie kalkulatora.

Drugie polecenie używa Get-Process pobiera obiekt reprezentujący proces Calc, a następnie zapisuje go w zmiennej $p.

Trzecie polecenie zatrzymuje proces Calc. Używa parametru InputObject, aby przekazać obiekt do Stop-Process.

Ostatnie polecenie pobiera wszystkie procesy na komputerze, na którym były uruchomione, ale są teraz zatrzymane. Używa Get-Process, aby pobrać wszystkie procesy na komputerze. Operator potoku (|) przekazuje wyniki do Where-Object polecenia cmdlet, które wybiera te, w których wartość właściwości HasExited jest $true. HasExited jest tylko jedną właściwością obiektów procesu. Aby znaleźć wszystkie właściwości, wpisz Get-Process | Get-Member.

Przykład 4. Zatrzymywanie procesu, który nie jest własnością bieżącego użytkownika

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

Te polecenia pokazują efekt użycia Force, aby zatrzymać proces, który nie jest własnością użytkownika.

Pierwsze polecenie używa Get-Process do pobrania procesu Lsass. Operator potoku wysyła proces do Stop-Process, aby go zatrzymać. Jak pokazano w przykładowych danych wyjściowych, pierwsze polecenie kończy się niepowodzeniem z komunikatem Odmowa dostępu, ponieważ ten proces można zatrzymać tylko przez członka grupy Administrator na komputerze.

Gdy program PowerShell zostanie otwarty przy użyciu opcji Uruchom jako administrator, a polecenie zostanie powtórzone, program PowerShell wyświetli monit o potwierdzenie.

Drugie polecenie określa Wymuszanie pomijanie wiersza polecenia. W związku z tym proces zostanie zatrzymany bez potwierdzenia.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Force

Zatrzymuje określone procesy bez monitowania o potwierdzenie. Domyślnie Stop-Process monituje o potwierdzenie przed zatrzymaniem jakiegokolwiek procesu, który nie jest własnością bieżącego użytkownika.

Aby znaleźć właściciela procesu, użyj polecenia cmdlet Get-CimInstance, aby uzyskać obiekt Win32_Process reprezentujący proces, a następnie użyć metody GetOwner obiektu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Id

Określa identyfikatory procesów do zatrzymania. Aby określić wiele identyfikatorów, użyj przecinków, aby oddzielić identyfikatory. Aby znaleźć identyfikator PID procesu, wpisz Get-Process.

Właściwości parametru

Typ:	Int32[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

Position:	0
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-InputObject

Określa obiekty procesu do zatrzymania. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

Właściwości parametru

Typ:	Process[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

InputObject

Position:	0
Obowiązkowy:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Name

Określa nazwy procesów do zatrzymania. Można wpisać wiele nazw procesów, rozdzielonych przecinkami lub użyć symboli wieloznacznych.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	True
DontShow:	False
Aliasy:	Nazwa procesu

Zestawy parametrów

Name

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-PassThru

Zwraca obiekt reprezentujący proces. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Process

Do tego polecenia cmdlet można przekazać obiekt procesu.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Process

Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekt procesu reprezentujący zatrzymany proces.

Uwagi

Program PowerShell zawiera następujące aliasy dla Stop-Process:

Wszystkie platformy:
- spps
Windows:
- kill

Można również użyć właściwości i metod obiektu instrumentacji zarządzania Windows (WMI) Win32_Process w programie Windows PowerShell. Aby uzyskać więcej informacji, zobacz Get-CimInstance i zestaw WMI SDK.

Podczas zatrzymywania procesów należy pamiętać, że zatrzymanie procesu może zatrzymać proces i usługi, które zależą od procesu. W skrajnym przypadku zatrzymanie procesu może zatrzymać system Windows.

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij za pomocą

Stop-Process

Składnia

Id (Domyślna)

Name

InputObject

Opis

Przykłady

Przykład 1. Zatrzymanie wszystkich wystąpień procesu

Przykład 2. Zatrzymanie określonego wystąpienia procesu

Przykład 3. Zatrzymanie procesu i wykrycie, że proces został zatrzymany

Przykład 4. Zatrzymywanie procesu, który nie jest własnością bieżącego użytkownika

Parametry

-Confirm

Właściwości parametru

Zestawy parametrów

-Force

Właściwości parametru

Zestawy parametrów

-Id

Właściwości parametru

Zestawy parametrów

-InputObject

Właściwości parametru

Zestawy parametrów

-Name

Właściwości parametru

Zestawy parametrów

-PassThru

Właściwości parametru

Zestawy parametrów

-WhatIf

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

Process

Dane wyjściowe

None

Process

Uwagi

Linki powiązane

Sprzężenie zwrotne