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
В этом примере служба IIS Администратор останавливается на локальном компьютере. Так как остановка этой службы также останавливает службы, зависящие от службы IIS Администратор, лучше всего предшествуть Stop-Service
команде, которая перечисляет службы, зависящие от службы IIS Администратор.
Первая команда указывает службы, зависимые от IISAdmin. Он используется Get-Service
для получения объекта, представляющего службу IIS Администратор. Оператор конвейера (|
) передает результат командлету Format-List
. Команда использует параметр Property для перечисления Format-List
только свойств name и зависимых служб службы.
Вторая команда останавливает службу 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 .
Связанные ссылки
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по