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

Suspend-Service

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

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

Синтаксис

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

Описание

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

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

Запрос подтверждения перед выполнением командлета.

Тип: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

-Include

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

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

-InputObject

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

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

-Name

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

Имя параметра является необязательным. Вы можете использовать имя или его псевдоним, ServiceName или вы можете опустить имя параметра.

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

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

  • 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.