Stop-Service
Останавливает одну или несколько запущенных служб.
Синтаксис
InputObject (По умолчанию)
Stop-Service
[-InputObject] <ServiceController[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Stop-Service
[-Name] <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Stop-Service
-DisplayName <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Stop-Service отправляет сообщение остановки контроллеру службы Windows для каждой из указанных служб. Вы можете указать службы по именам служб или отображаемым именам или использовать параметр InputObject для передачи объекта службы, представляющего службу, которую требуется остановить.
Примеры
Пример 1. Остановка службы на локальном компьютере
PS C:\> Stop-Service -Name "sysmonlog"
Эта команда останавливает службу журналов производительности и оповещений (SysmonLog) на локальном компьютере.
Пример 2. Остановка службы с помощью отображаемого имени
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Эта команда останавливает службу Telnet на локальном компьютере. Команда использует Get-Service для получения объекта, представляющего службу Telnet. Оператор конвейера (|) передает объект в Stop-Service, который останавливает службу.
Пример 3. Остановка службы с зависимыми службами
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
В этом примере служба IISAdmin останавливается на локальном компьютере. Так как остановка этой службы также останавливает службы, зависящие от службы IISAdmin, лучше предшествовать Stop-Service с помощью команды, которая перечисляет службы, зависящие от службы IISAdmin.
Первая команда содержит службы, зависящие от IISAdmin. Он использует Get-Service для получения объекта, представляющего службу IISAdmin. Оператор конвейера (|) передает результат командлету Format-List. Команда использует параметр свойства Format-List для перечисления только свойств Name и Зависимых служб.
Вторая команда останавливает службу IISAdmin. Параметр Force требуется для остановки службы с зависимыми службами. Команда использует параметр Confirm, чтобы запросить подтверждение от пользователя перед остановкой каждой службы.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Указывает отображаемые имена служб, которые необходимо остановить. Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
DisplayName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Exclude
Указывает службы, которые этот командлет пропускает. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например s*. Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Заставляет командлет остановить службу, даже если эта служба имеет зависимые службы.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Include
Указывает службы, которые останавливает этот командлет. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например s*. Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает объекты ServiceController, представляющие службы для остановки. Введите переменную, содержащую объекты, или введите команду или выражение, которое получает объекты.
Свойства параметров
| Тип: | |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
InputObject
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имена служб, которые необходимо остановить. Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
| Aliases: | Название сервиса |
Наборы параметров
Default
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-NoWait
Указывает, что этот командлет использует параметр ожидания без ожидания.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает объект, представляющий службу. По умолчанию этот командлет не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
ServiceController
Объект сервиса можно передать в этот командлет в качестве параметра.
String
Можно передать строку, содержащую имя службы в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
ServiceController
При использовании параметра PassThru этот командлет возвращает объект ServiceController, представляющий службу.
Примечания
Windows PowerShell включает следующие псевдонимы для Stop-Service:
spsv
Stop-Service может управлять службами только в том случае, если у текущего пользователя есть разрешение на это. Если команда не работает правильно, возможно, у вас нет необходимых разрешений.
Чтобы найти имена служб и отображаемые имена служб в системе, введите Get-Service. Имена служб отображаются в столбце имени
