Останавливает один или несколько выполняющихся процессов.

Синтаксис

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

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

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

Описание

Командлет Stop-Process останавливает один или несколько выполняющихся процессов. Процесс для командлета Stop-Process можно указать при помощи имени, идентификатора (PID) или объекта процесса. Командлет Stop-Process работает только с процессами, выполняющимися на локальном компьютере.

В Windows Vista и более поздних версиях Windows для остановки процесса, владельцем которого не является текущий пользователь, необходимо запускать Windows PowerShell командой "Запуск от имени администратора". Кроме того, командлет запрашивает разрешение, если не задан параметр Force.

Параметры

-Force

Останавливает заданные процессы без запроса подтверждения. По умолчанию командлет Stop-Process запрашивает подтверждение перед удалением процессов, владельцем которых не является текущий пользователь.

Чтобы определить владельца процесса, необходимо с помощью командлета Get-WmiMethod получить объект Win32_Process, представляющий процесс, а затем использовать метод GetOwner объекта.

Обязательно?

false

Позиция?

named

Значение по умолчанию

False

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Id <Int32[]>

Задает идентификаторы останавливаемых процессов. При вводе нескольких идентификаторов необходимо разделять их запятыми. Чтобы определить идентификатор процесса, введите команду Get-Process. Имя параметра ("Id") указывать необязательно.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-InputObject <Process[]>

Останавливает процессы, представленные указанными объектами процессов. Введите переменную, содержащую объекты, либо команду или выражение для получения объектов.

Обязательно?

true

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByValue)

Принимать подстановочные знаки?

false

-Name <string[]>

Задает имена останавливаемых процессов. Можно ввести несколько имен процессов, разделяя их запятыми, либо использовать подстановочные знаки.

Обязательно?

true

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-PassThru

Возвращает объект, представляющий процесс. По умолчанию этот командлет не формирует никаких выходных данных.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Confirm

Запрашивает подтверждение перед выполнением команды.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

System.Diagnostics.Process

Объект процесса можно передать командлету Stop-Process по конвейеру.

Выходные данные

Нет или System.Diagnostics.Process

Если задан параметр PassThru, командлет Stop-Process возвращает объект System.Diagnostics.Process, представляющий остановленный процесс. В противном случае этот командлет не формирует никаких выходных данных.

Примечания

Командлет Stop-Process также можно вызывать с помощью встроенных псевдонимов "kill" и "spps". Дополнительные сведения см. в разделе About_Aliases.

В оболочке Windows PowerShell также можно использовать свойства и методы объекта Win32_Process инструментария управления Windows (WMI). Дополнительные сведения см. в разделах о командлете Get-WmiObject и пакете SDK WMI.

При остановке процессов необходимо учитывать, что остановка процесса может повлечь за собой остановку зависимых от него процессов и служб. Остановка некоторых процессов в крайних случаях может вызвать остановку Windows.

Пример 1

C:\PS>stop-process -name notepad

Описание
-----------
Эта команда останавливает все экземпляры процесса Notepad на компьютере. (Каждый экземпляр процесса Notepad выполняется в отдельном процессе.) Для задания процессов используется параметр Name: все экземпляры процесса имеют одинаковое имя. При обращении к экземплярам с помощью идентификаторов необходимо было бы перечислить идентификаторы всех экземпляров процесса Notepad.






Пример 2

C:\PS>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

Описание
-----------
Эта команда останавливает конкретный экземпляр процесса Notepad. Для задания процесса используется его идентификатор: 3952. Параметр Confirm указывает оболочке Windows PowerShell запрашивать подтверждение пользователя на остановку процесса. Такая форма является наиболее удобной, так как запрос включает в себя как имя, так и идентификатор процесса. Параметр PassThru передает объект процесса модулю форматирования для отображения. Если бы этот параметр не использовался, после выполнения команды Stop-Process не выводилось бы никаких сообщений.






Пример 3

C:\PS>calc

c:\PS>$p = get-process calc

c:\PS>stop-process -inputobject $p

c:\PS>get-process | where-object {$_.HasExited}

Описание
-----------
Данная последовательность команд запускает и останавливает процесс Calc, а затем определяет остановленные процессы. 

Первая команда ("calc") запускает экземпляр приложения "Калькулятор". Вторая команда ("$p = get-process calc") с помощью командлета Get-Process извлекает объект, представляющий процесс Calc, и сохраняет его в переменной $p. Третья команда ("stop-process -inputobject $p") с помощью командлета Stop-Process останавливает процесс Calc. Объект передается командлету Stop-Process с помощью параметра InputObject. 

Последняя команда получает все процессы компьютера, которые работали ранее, но были остановлены. Для получения всех процессов на компьютере используется командлет Get-Process. Оператор конвейера (|) передает результаты командлету Where-Object, который выбирает из них те, у которых свойство HasExited имеет значение TRUE. HasExited — это только одно из множества свойств объектов процессов. Чтобы просмотреть все свойства, введите "get-process | get-member".






Пример 4

C:\PS>get-process 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 lsass  | stop-process <<<<

[ADMIN]: C:\PS> get-process 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]: C:\PS> get-process lsass | stop-process -force
[ADMIN]: C:\PS>

Описание
-----------
Приведенные команды демонстрируют использование параметра Force для остановки процесса, владельцем которого пользователь не является.

Первая команда с помощью командлета Get-Process получает процесс Lsass. С помощью оператора конвейера (|) процесс пересылается командлету Stop-Process, который должен остановить процесс. Как видно из примера выходных данных, первая команда завершается с ошибкой "Отказано в доступе", поскольку этот процесс может быть остановлен только членом группы "Администраторы" компьютера.

После запуска оболочки Windows PowerShell командой "Запуск от имени администратора" и повторения команды Windows PowerShell запрашивает подтверждение.

Во второй команде используется параметр Force для отключения запроса. В результате процесс останавливается без подтверждения.






См. также




Содержание