ServiceSet

Статья
05/05/2023

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

Управление несколькими службами с помощью общих параметров.

Синтаксис

ServiceSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    [Ensure = [String]]
    [StartupType = [String]]
    [BuiltInAccount = [String]]
    [State = [String]]
    [Credential = [PSCredential]]
}

Описание

ServiceSet — это составной ресурс, который упрощает управление несколькими службами одновременно с общими, но ограниченными конфигурациями. Этот ресурс может обновлять или удалять существующие службы. Не удается создать службы. Дополнительные сведения о настройке служб см. в разделе "Ресурс службы".

Важно!

Составные ресурсы не работают с Invoke-DscResource. Этот ресурс доступен только в определении Configuration .

Требования

Нет.

Элемент Property

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

Имя

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

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

Type: System.String[]
Behavior: Key

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

BuiltInAccount

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

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

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

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

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

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

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

Ensure

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

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

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

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

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