Stop-Service
Останавливает одну или несколько запущенных служб.
Синтаксис
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет 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
. Команда использует параметр Property для Format-List
вывода списка только свойств Name и DependentServices службы.
Вторая команда останавливает службу IISAdmin. Параметр Force необходим для остановки службы с зависимыми службами. Команда использует параметр Confirm для запроса подтверждения у пользователя перед остановкой каждой службы.
Параметры
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Указывает отображаемые имена служб для остановки. Можно использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Указывает службы, которые пропускает этот командлет. Значение этого параметра квалифифициирует параметр Name . Введите часть имени или шаблон, например "s*". Можно использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Заставляет командлет остановить службу, даже если у нее есть зависимые службы.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Указывает службы, которые этот командлет останавливает. Значение этого параметра квалифифициирует параметр Name . Введите часть имени или шаблон, например "s*". Можно использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Указывает объекты ServiceController , представляющие службы для остановки. Введите переменную, которая содержит объекты, или команду или выражение, которое возвращает объекты.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает имена служб для остановки. Можно использовать подстановочные знаки.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoWait
Указывает, что этот командлет использует параметр без ожидания.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Возвращает объект, представляющий службу. По умолчанию этот командлет не создает выходные данные.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Объект службы можно передать в этот командлет по конвейеру.
Вы можете передать строку, содержащую имя службы, в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
При использовании параметра PassThru этот командлет возвращает объект ServiceController , представляющий службу.
Примечания
PowerShell включает следующие псевдонимы для Stop-Service
:
- Windows:
spsv
Этот командлет доступен только на платформах Windows.
Stop-Service
может управлять службами только в том случае, если у текущего пользователя есть разрешение на это. Если команда работает неправильно, возможно, у вас нет необходимых разрешений.
Чтобы найти имена служб и отображаемые имена в системе, введите Get-Service
. Имена служб отображаются в столбце Имя , а отображаемые имена — в столбце DisplayName .