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

Синтаксис

Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

Командлет Stop-Service отсылает сообщение об остановке диспетчеру служб Windows для каждой указанной службы. Службы можно задавать с помощью их имен или отображаемых имен. Кроме того, можно с помощью параметра InputObject передавать объекты, представляющие останавливаемые службы.

Параметры

-DisplayName <string[]>

Задает отображаемые имена останавливаемых служб. Подстановочные знаки разрешены.

Обязательно?	true
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Exclude <string[]>

Исключает указанные службы. Значение данного параметра определяет значение параметра Name. Введите часть имени или шаблон, например "s*". Подстановочные знаки разрешены.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Force

Позволяет командлету остановить службу, даже если у нее есть зависимые службы.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Include <string[]>

Останавливает только указанные службы. Значение данного параметра определяет значение параметра Name. Введите часть имени или шаблон, например "s*". Подстановочные знаки разрешены.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-InputObject <ServiceController[]>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-Name <string[]>

Задает имена останавливаемых служб. Подстановочные знаки разрешены.

Имя параметра указывать необязательно. Можно использовать параметр "Name" или его псевдоним "ServiceName", либо опустить имя параметра.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue, 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.ServiceProcess.ServiceController или System.String.

Можно передать объект службы или строку, содержащую имя службы, по конвейеру командлету Stop-Service.

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

Нет или System.ServiceProcess.ServiceController

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

Примечания

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

Командлет Stop-Service может использоваться для управления службами, только если у текущего пользователя есть на это разрешение. Некорректная работа команды может быть обусловлена отсутствием требуемых разрешений.

Чтобы извлечь имена служб и отображаемые имена служб на текущем компьютере, введите команду "Get-Service". Имена служб содержатся в столбце Name, а отображаемые имена — в столбце DisplayName.

Пример 1

C:\PS>stop-service sysmonlog

Описание
-----------
Эта команда останавливает службу "Журналы и оповещения производительности" (SysmonLog) на локальном компьютере.

Пример 2

C:\PS>get-service -displayname telnet | stop-service

Описание
-----------
Эта команда останавливает службу Telnet на локальном компьютере. Для извлечения объекта, представляющего службу Telnet, используется командлет Get-Service. Оператор конвейера (|) пересылает объект командлету Stop-Service, который останавливает службу.

Пример 3

C:\PS>get-service iisadmin | format-list -property name, dependentservices

C:PS>stop-service iisadmin -force -confirm

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

Первая команда отображает список всех служб, зависимых от IISAdmin. Для извлечения объекта, представляющего службу IISAdmin, используется командлет Get-Service. Оператор конвейера (|) передает результат командлету Format-List. Для вывода на экран только значений свойств Name и DependentServices службы в команде Format-List используется параметр Property.

Вторая команда останавливает работу службы IISAdmin. Параметр Force необходим для остановки служб, имеющих связанные с ними зависимые службы. Для запроса подтверждения пользователя на остановку каждой службы используется параметр Confirm.

Stop-Service