Поделиться через

Stop-Service

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

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

Синтаксис

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>]

Описание

Командлет 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

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplayName

Указывает отображаемые имена служб, которые необходимо остановить. Разрешены подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Exclude

Указывает службы, которые этот командлет пропускает. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например s*. Разрешены подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Include

Указывает службы, которые останавливает этот командлет. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например s*. Разрешены подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-InputObject

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

Тип:ServiceController[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имена служб, которые необходимо остановить. Разрешены подстановочные знаки.

Тип:String[]
Aliases:ServiceName
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-NoWait

Указывает, что этот командлет использует параметр ожидания без ожидания.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

ServiceController

Объект службы можно передать в этот командлет.

String

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

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

None

По умолчанию этот командлет не возвращает выходные данные.

ServiceController

При использовании параметра PassThru этот командлет возвращает объект ServiceController, представляющий службу.

Примечания

Windows PowerShell включает следующие псевдонимы для Stop-Service:

  • spsv

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

Чтобы найти имена служб и отображаемые имена служб в системе, введите Get-Service. Имена служб отображаются в столбце имени и отображаемые имена отображаются в столбце DisplayName.