Возобновляет работу приостановленных служб.

Синтаксис

Resume-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Resume-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Resume-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

Командлет Resume-Service отсылает сообщение о возобновлении работы диспетчеру служб Windows для каждой указанной службы. Если служба была приостановлена, ее работа будет возобновлена. Если служба запущена, сообщение игнорируется. Службы можно задавать с помощью их имен или отображаемых имен. Кроме того, можно с помощью параметра InputObject передавать объекты, представляющие возобновляемые службы.

Параметры

-DisplayName <string[]>

Задает отображаемые имена возобновляемых служб. Подстановочные знаки разрешены.

Обязательно?	true
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Exclude <string[]>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Include <string[]>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-InputObject <ServiceController[]>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-Name <string[]>

Задает имена возобновляемых служб.

Имя параметра указывать необязательно. Можно использовать "-Name" или его псевдоним ("-ServiceName") либо опустить имя параметра.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue, ByPropertyName)
Принимать подстановочные знаки?	false

-PassThru

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Confirm

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

System.ServiceProcess.ServiceController или System.String.

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

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

Нет или System.ServiceProcess.ServiceController

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

Примечания

Состояние приостановленных служб имеет значение "Paused". При возобновлении их работы состояние имеет значение "Running".

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

Чтобы извлечь имена служб и отображаемые имена служб на текущем компьютере, введите команду "Get-Service". Имена служб содержатся в столбце Name, а отображаемые имена — в столбце DisplayName.

Пример 1

C:\PS>resume-service sens

Описание
-----------
Эта команда возобновляет работу службы System Event Notification (имя службы в команде — "sens") на локальном компьютере. В команде используется параметр Name для задания имени службы, при этом имя параметра опускается, так как оно является необязательным.

Пример 2

C:\PS>get-service | where-object {$_.Status -eq "Paused"} | resume-service

Описание
-----------
Эта команда возобновляет работу всех приостановленных служб компьютера. Первая команда извлекает все службы на компьютере. Оператор конвейера (|) передает результаты командлету Where-Object, который выбирает из них те, у которых свойство Status имеет значение "Paused" (приостановлена). Следующий оператор конвейера передает результаты командлету Resume-Service, который возобновляет работу приостановленных служб.

На практике, чтобы узнать о последствиях выполнения команды без ее использования, используется параметр WhatIf.

Resume-Service