Suspend-Service
Приостанавливает одну или несколько запущенных служб.
Синтаксис
Suspend-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Suspend-Service
отправляет сообщение приостановки контроллеру службы Windows для каждой из указанных служб. Пока служба приостановлена, она по-прежнему работает, но ее действие останавливается до возобновления, например с помощью командлета Resume-Service
. Службы можно указать по именам служб или отображаемым именам, а также использовать параметр InputObject для передачи объекта службы, представляющего службы, которые требуется приостановить.
Примеры
Пример 1. Приостановка службы
PS C:\> Suspend-Service -DisplayName "Telnet"
Эта команда приостанавливает службу Telnet (Tlntsvr) на локальном компьютере.
Пример 2. Отображение того, что произойдет при приостановке служб
PS C:\> Suspend-Service -Name lanman* -WhatIf
Эта команда сообщает, что произойдет, если вы приостановили службы с именем службы, начинающимся с lanman. Чтобы приостановить работу служб, повторно выполните команду без параметра WhatIf .
Пример 3. Получение и приостановка службы
PS C:\> Get-Service schedule | Suspend-Service
Эта команда использует Get-Service
командлет для получения объекта, представляющего службу планировщика задач (расписание) на компьютере. Оператор конвейера (|
) передает результат в Suspend-Service
, что приостанавливает работу службы.
Пример 4. Приостановка всех служб, которые могут быть приостановлены
PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm
Эта команда приостанавливает все службы на компьютере, которые можно приостановить. Он использует Get-Service
для получения объектов, представляющих службы на компьютере. Оператор конвейера передает результаты командлету Where-Object
, который выбирает только службы, имеющие значение $True
для свойства CanPauseAndContinue . Другой оператор конвейера передает результаты в Suspend-Service
. Параметр 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 |
-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
Указывает имена служб, которые необходимо приостановить. Можно использовать подстановочные знаки.
Имя параметра является необязательным. Можно использовать имя или его псевдоним ServiceName или опустить имя параметра.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-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.
Suspend-Service
может управлять службами только в том случае, если у текущего пользователя есть разрешение на это. Если команда работает неправильно, возможно, у вас нет необходимых разрешений.Suspend-Service
может приостанавливать только службы, поддерживающие приостановку и возобновление. Чтобы определить, можно ли приостановить определенную службу, используйтеGet-Service
командлет вместе со свойством CanPauseAndContinue . Например,Get-Service wmi | Format-List Name, CanPauseAndContinue
. Чтобы найти все службы на компьютере, которые можно приостановить, введитеGet-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
.- Чтобы найти имена служб и отображаемые имена в системе, введите
Get-Service
. Имена служб отображаются в столбце Имя , а отображаемые имена — в столбце DisplayName .