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

Set-Service

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

Запускает, останавливает и приостанавливает службу и изменяет его свойства.

Синтаксис

Set-Service
   [-Name] <String>
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Service
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-InputObject <ServiceController>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-Service изменяет свойства службы, например состояние, описание, DisplayNameи StartupType. Set-Service может запускать, останавливать, приостановить или приостановить службу. Чтобы определить службу, введите имя службы или отправьте объект службы. Или отправьте имя службы или объект службы вниз по конвейеру в Set-Service.

Примеры

Пример 1. Изменение отображаемого имени

В этом примере отображаемое имя службы изменяется. Чтобы просмотреть исходное отображаемое имя, используйте Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

использует параметр имени для указания имени службы LanmanWorkstation. Параметр displayName displayName задает новое отображаемое имя Рабочая станция 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 задает службу для автоматического.

использует параметр имени , чтобы указать службу BITS и отправить объект вниз конвейера. использует параметр свойства для отображения состояния службы 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 и отображает имя и описание службы. Для сравнения команда выполняется до и после обновления описания.

использует параметр имени , чтобы указать службу 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

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

Пример 6. Остановка службы

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

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

использует параметр имени для указания службы расписания. Объект хранится в переменной $S. Set-Service использует параметр InputObject и задает объект, сохраненный $S. Параметр состояния задает службе значение Остановлено.

Параметры

-ComputerName

Указывает один или несколько компьютеров. Для удаленных компьютеров введите имя NetBIOS, IP-адрес или полное доменное имя. Если параметр ComputerName не указан, команда выполняется на локальном компьютере.

Этот параметр не зависит от удаленного взаимодействия PowerShell. Вы можете использовать параметр ComputerName, даже если компьютер не настроен для выполнения удаленных команд.

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

-Confirm

Запрашивает подтверждение перед запуском Set-Service.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Задает новое описание службы.

Описание службы отображается в управления компьютерами, службами. Description не является свойством объекта Get-ServiceServiceController. Чтобы просмотреть описание службы, используйте Get-CimInstance, возвращающий объект Win32_Service, представляющий службу.

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

-DisplayName

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

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

-InputObject

Указывает объект ServiceController, представляющий службу для изменения. Введите переменную, содержащую объект, или введите команду или выражение, которое получает объект, например команду Get-Service. Конвейер можно использовать для отправки объекта службы в Set-Service.

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

-Name

Указывает имя службы, которое необходимо изменить. Подстановочные знаки не разрешены. Конвейер можно использовать для отправки имени службы в Set-Service.

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

-PassThru

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

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

-StartupType

Указывает начальный режим службы.

Допустимые значения для этого параметра приведены следующим образом:

  • автоматические. Запускается при запуске системы.
  • отключены. Не удается запустить службу.
  • вручную. Запускается только при запуске пользователем или программой.
Тип:ServiceStartMode
Aliases:StartMode, SM, ST
Допустимые значения:Automatic, Boot, Disabled, Manual, System
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Status

Указывает состояние службы.

Допустимые значения для этого параметра приведены следующим образом:

  • приостановлены. Приостанавливает работу службы.
  • выполнение. Запускает службу.
  • остановлено. Останавливает службу.
Тип:String
Допустимые значения:Paused, Running, Stopped
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если Set-Service выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

System.ServiceProcess.ServiceController, System.String

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

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

ServiceController

По умолчанию Set-Service не возвращает объекты. Используйте параметр PassThru для вывода объекта ServiceController.

Примечания

Set-Service требуются повышенные разрешения. Используйте параметр запуска от имени администратора.

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

Чтобы найти имя службы или отображаемое имя службы, используйте Get-Service. Имена служб находятся в столбце имени , а отображаемые имена находятся в столбце DisplayName.