Set-Service
Запускает, останавливает и приостанавливает службу и изменяет его свойства.
Синтаксис
Name (По умолчанию)
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-Service
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-InputObject <ServiceController>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-Service изменяет свойства службы, такие как Status, Description, DisplayNameи StartupType.
Set-Service может запускать, останавливать, приостановить или поставить на паузу службу. Чтобы определить службу, введите имя службы или отправьте объект службы. Или отправьте имя службы или объект службы вниз по конвейеру в Set-Service.
Примеры
Пример 1. Изменение отображаемого имени
В этом примере отображаемое имя службы изменяется. Чтобы просмотреть исходное отображаемое имя, используйте Get-Service.
Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"
Set-Service использует параметр имени для указания имени службы LanmanWorkstation. Параметр задает новое отображаемое имя, Рабочая станция LanMan .
Пример 2. Изменение типа запуска служб
В этом примере показано, как изменить тип запуска службы.
Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status
Name StartType Status
---- --------- ------
BITS Automatic Running
Set-Service использует параметр Name для указания имени службы BITS. Параметр StartupType устанавливает службу на автоматический.
Get-Service использует параметр имени, чтобы задать службу BITS и отправить объект по конвейерному каналу.
Select-Object использует параметр из свойства для отображения состояния службы BITS.
Пример 3. Изменение описания службы
В этом примере изменяется описание службы BITS и отображается результат.
Командлет Get-CimInstance используется, так как возвращает объект Win32_Service, включающий описание службы .
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
disabled, then any applications that depend on BITS, such as Windows Update or MSN
Explorer, will be unable to automatically download programs and other information.
Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth.
Get-CimInstance отправляет объект вниз по конвейеру в Format-List и отображает имя и описание службы. Для сравнения команда выполняется до и после обновления описания.
Set-Service использует параметр имени, чтобы указать службу BITS. Параметр Описание задает обновленный текст для описания служб.
Пример 4. Запуск службы
В этом примере запускается служба.
Set-Service -Name WinRM -Status Running -PassThru
Status Name DisplayName
------ ---- -----------
Running WinRM Windows Remote Management (WS-Manag...
Set-Service использует параметр Name для указания службы WinRM. Параметр состояния использует значение работа для запуска службы. Параметр PassThru выводит объект ServiceController, отображающий результаты.
Пример 5. Приостановка службы
В этом примере конвейер используется для паузы на обслуживание.
Get-Service -Name Schedule | Set-Service -Status Paused
Get-Service использует параметр имени , чтобы указать сервис Schedule и переслать объект по конвейеру.
Set-Service использует параметр состояния для установки службы на приостановленное.
Пример 6. Остановка службы
В этом примере используется переменная для остановки службы.
$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped
Get-Service использует параметр имени для указания службы расписания. Объект хранится в переменной $S.
Set-Service использует параметр InputObject и задает объект, сохраненный $S. Параметр состояния задает службе значение Остановлено.
Пример 7. Установка типа запуска для нескольких служб
Командлет Set-Service принимает только одно имя службы одновременно. Однако можно передать несколько служб в Set-Service, чтобы изменить конфигурацию нескольких служб.
Get-Service SQLWriter,spooler |
Set-Service -StartupType Automatic -PassThru |
Select-Object Name, StartType
Name StartType
---- ---------
spooler Automatic
SQLWriter Automatic
Параметры
-ComputerName
Указывает один или несколько компьютеров. Для удаленных компьютеров введите имя NetBIOS, IP-адрес или полное доменное имя. Если параметр ComputerName не указан, команда выполняется на локальном компьютере.
Этот параметр не зависит от удаленного управления PowerShell. Вы можете использовать параметр ComputerName, даже если компьютер не настроен для выполнения удаленных команд.
Свойства параметров
| Тип: | String[] |
| Default value: | Local computer |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | цн |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском Set-Service.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Задает новое описание службы.
Описание службы отображается в Управление компьютером, Службы.
Description не является свойством объекта Get-ServiceServiceController. Чтобы просмотреть описание службы, используйте Get-CimInstance, возвращающий объект Win32_Service, представляющий службу.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Задает новое отображаемое имя службы.
Замечание
Как правило, Set-Service работает только в службах Windows, а не драйверах. Однако если указать имя драйвера, Set-Service может нацелиться на драйвер.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | ДН |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает объект ServiceController, представляющий службу для изменения. Введите переменную, содержащую объект, или введите команду или выражение, которое получает объект, например команду Get-Service. Конвейер можно использовать для отправки служебного объекта в Set-Service.
Свойства параметров
| Тип: | ServiceController |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
InputObject
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя службы, которое необходимо изменить. Подстановочные знаки не разрешены. Вы можете использовать конвейер для отправки имени службы в Set-Service.
Замечание
Как правило, Set-Service работает только в службах Windows, а не драйверах. Однако если указать имя драйвера, Set-Service может нацелиться на драйвер.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Название сервиса, SN |
Наборы параметров
Name
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает объект ServiceController, представляющий измененные службы. По умолчанию Set-Service не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-StartupType
Задает тип запуска службы. Допустимые значения для этого параметра:
-
Automatic— служба запущена или запущена операционной системой при запуске системы. Если служба автоматического запуска зависит от службы, запущенной вручную, служба вручную запускается автоматически при запуске системы. -
Disabled— служба отключена и не может быть запущена пользователем или приложением. -
Manual— служба запускается только вручную, пользователем, с помощью диспетчера управления службами или приложением. -
Boot— Указывает, что служба является драйвером устройства, запущенным загрузчиком системы. Это значение допустимо только для драйверов устройств. -
System— Указывает, что служба является драйвером устройства, запущенным функцией IOInitSystem(). Это значение допустимо только для драйверов устройств.
Значение по умолчанию — Automatic.
Свойства параметров
| Тип: | ServiceStartMode |
| Default value: | Automatic |
| Допустимые значения: | Boot, System, Automatic, Manual, Disabled |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | StartMode, SM, УЛ |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Status
Указывает статус службы.
Допустимые значения для этого параметра приведены следующим образом:
-
Paused. Приостанавливает службу. -
Running. Запускает службу. -
Stopped. Останавливает службу.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Допустимые значения: | Paused, Running, Stopped |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если Set-Service будет запущен. Командлет не выполняется.
Свойства параметров
| Тип: | 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.
Примечания
Set-Service требуются повышенные разрешения. Используйте параметр Запустить от имени администратора.
Set-Service может управлять только службами, если у текущего пользователя есть разрешения на управление службами. Если команда не работает правильно, возможно, у вас нет необходимых разрешений.
Чтобы найти имя службы или отображаемое имя службы, используйте Get-Service. Названия сервисов находятся в столбце Name, а отображаемые имена находятся в столбце DisplayName.
