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

Служба

  • Статья

Краткий обзор

Управление службой Windows.

Синтаксис

Service [String] #ResourceName
{
    Name = [string]
    [BuiltInAccount = [string]{ LocalService | LocalSystem | NetworkService }]
    [Credential = [PSCredential]]
    [Dependencies = [string[]]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [DesktopInteract = [bool]]
    [DisplayName = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [string]]
    [PsDscRunAsCredential = [PSCredential]]
    [StartupTimeout = [UInt32]]
    [StartupType = [string]{ Automatic | Disabled | Manual }]
    [State = [string]{ Ignore | Running | Stopped }]
    [TerminateTimeout = [UInt32]]
}

Описание

Ресурс Service позволяет добавлять, обновлять и удалять службы.

Требования

Нет.

свойства ключа;

Имя

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

Примечание

Иногда это значение отличается от отображаемого имени. Список служб и их текущее состояние можно получить с помощью командлета Get-Service.

Type: System.String

Необязательные свойства

BuiltInAccount

Укажите имя учетной записи компьютера для запуска службы от имени. Чтобы запустить службу, учетная запись должна иметь доступ к исполняемому файлу, указанному в path .

Не указывайте это свойство со свойством Credential .

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

Учетные данные

Укажите учетные данные для учетной записи, в качестве запуска службы. Чтобы запустить службу, учетная запись должна иметь доступ к исполняемому файлу, указанному в path . Ресурс автоматически предоставляет этой учетной записи право "Войти как услуга".

Не указывайте это свойство со свойством BuiltInAccount .

Type: System.Management.Automation.PSCredential
Default Value: None

Зависимости

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

Type: System.String[]
Default Value: None

Описание

Укажите описание службы в виде строки. Описание службы отображается в разделе "Управление компьютером", "Службы".

Type: System.String
Default Value: None

DesktopInteract

Укажите, может ли служба создавать или взаимодействовать с окном на рабочем столе. Это свойство должно быть $false , если BuiltInAccount не указан как LocalSystem.

Значение по умолчанию — $false.

Type: System.Boolean
Default Value: false

DisplayName

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

Type: System.String
Default Value: None

Ensure

Укажите, должна ли служба существовать. Чтобы добавить или обновить службу, задайте для этого свойства значение Present. Чтобы удалить службу, задайте для этого свойства Absentзначение .

Значение по умолчанию — Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Path

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

Type: System.String
Default Value: None

StartupTimeout

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

Значение по умолчанию — 30000.

Type: System.UInt32
Default Value: 30000

StartupType

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

  • Automatic — Служба запускается операционной системой при запуске системы. Если автоматически запущенная служба зависит от службы, запущенной вручную, служба запускается вручную также автоматически при запуске системы.
  • Disabled — Служба отключена и не может быть запущена пользователем или приложением.
  • Manual — служба запускается только вручную, пользователем, с помощью диспетчера управления службами или приложением.

Если служба не существует, по умолчанию используется Automaticзначение .

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

Состояние

Укажите, должна ли служба выполняться. Это должно быть одно из следующих значений.

  • Running — ресурс запускает службу, если она еще не запущена.
  • Stopped — ресурс останавливает службу, если она запущена.
  • Ignore — ресурс не запускает или не останавливает службу.

Значение по умолчанию — Running.

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

TerminateTimeout

Укажите время ожидания остановки службы в миллисекундах. Значение по умолчанию — 30000.

Type: System.UInt32
Default Value: 30000

Примеры