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

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 . Команда использует параметр 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

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

System.ServiceProcess.ServiceController, System.String

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

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

None, System.ServiceProcess.ServiceController

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

Примечания

Этот командлет доступен только на платформах Windows.

Вы также можете ссылаться на Stop-Service его встроенный псевдоним spsv. Подробнее см. в разделе "about_Aliases".

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

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