Возобновляет работу приостановленных служб.
Синтаксис
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.
См. также