Suspend-Service
Приостанавливает одну или несколько запущенных служб.
Синтаксис
InputObject (По умолчанию)
Suspend-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Suspend-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Suspend-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет Suspend-Service отправляет сообщение приостановки контроллеру службы Windows для каждой из указанных служб. При приостановке служба по-прежнему работает, но ее действие останавливается до возобновления, например с помощью командлета Resume-Service. Вы можете указать службы по именам служб или отображаемым именам или использовать параметр InputObject для передачи объекта службы, представляющего службы, которые требуется приостановить.
Примеры
Пример 1. Приостановка службы
Suspend-Service -DisplayName "Telnet"
Эта команда приостанавливает службу Telnet (Tlntsvr) на локальном компьютере.
Пример 2. Отображение того, что произойдет при приостановке служб
Suspend-Service -Name lanman* -WhatIf
Эта команда сообщает, что произойдет, если вы приостановили службы с именем службы, начинающейся с lanman. Чтобы приостановить службы, повторно выполните команду без параметра WhatIf
Пример 3. Получение и приостановка службы
Get-Service schedule | Suspend-Service
Эта команда использует командлет Get-Service для получения объекта, представляющего службу планировщика задач (расписание) на компьютере. Оператор конвейера (|) передает результат Suspend-Service, который приостанавливает службу.
Пример 4. Приостановка всех служб, которые могут быть приостановлены
Get-Service |
Where-Object {$_.CanPauseAndContinue -eq "True"} |
Suspend-Service -Confirm
Эта команда приостанавливает все службы на компьютере, которые могут быть приостановлены. Он использует Get-Service для получения объектов, представляющих службы на компьютере. Оператор конвейера передает результаты командлету Where-Object, который выбирает только службы, имеющие значение $true для свойства CanPauseAndContinue. Другой оператор конвейера передает результаты Suspend-Service. Параметр Подтверждение запрашивает подтверждение перед приостановкой каждой службы.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Указывает отображаемые имена служб, которые будут приостановлены. Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
DisplayName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Exclude
Указывает службы, которые будут опущены из указанных служб. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например "s*". Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Include
Указывает службы для приостановки. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например "s*". Разрешено использование подстановочных символов.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает объекты ServiceController, представляющие службы для приостановки. Введите переменную, содержащую объекты, или введите команду или выражение, которое получает объекты.
Свойства параметров
| Тип: | |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
InputObject
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имена служб для приостановки. Разрешено использование подстановочных символов.
Имя параметра является необязательным. Вы можете использовать имени
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
| Aliases: | Название сервиса |
Наборы параметров
Default
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
ServiceController
Объект сервиса можно передать в этот командлет в качестве параметра.
String
Можно передать строку, содержащую имя службы в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
ServiceController
При использовании параметра PassThru этот командлет возвращает объект ServiceController, представляющий службу.
Примечания
Этот командлет доступен только на платформах Windows.
-
Suspend-Serviceможет управлять службами только в том случае, если у текущего пользователя есть разрешение на это. Если команда не работает правильно, возможно, у вас нет необходимых разрешений. -
Suspend-Serviceможет приостановить только службы, поддерживающие приостановку и возобновление работы. Чтобы определить, можно ли приостановить определенную службу, используйте командлетGet-Serviceвместе со свойством CanPauseAndContinue. Например:Get-Service wmi | Format-List Name, CanPauseAndContinue. Чтобы найти все службы на компьютере, который можно приостановить, введитеGet-Service | Where-Object {$_.CanPauseAndContinue -eq $true}. - Чтобы найти имена служб и отображаемые имена служб в системе, введите
Get-Service. Названия служб появляются в столбце Name, а отображаемые имена появляются в столбце DisplayName.
Начиная с PowerShell 6.0 команда больше не включает параметр ComputerName . Чтобы использовать эту команду на удаленном компьютере, используйте Invoke-Command эту команду для удаленной системы.
