Usługa

  • Artykuł

Streszczenie

Zarządzanie usługą systemu Windows.

Składnia

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]]
}

Opis

Zasób Service umożliwia dodawanie, aktualizowanie i usuwanie usług.

Wymagania

Brak.

Kluczowe właściwości

Nazwa

Określ nazwę usługi jako ciąg.

Uwaga

Czasami ta wartość różni się od nazwy wyświetlanej. Listę usług i ich bieżący stan można uzyskać za pomocą Get-Service polecenia cmdlet .

Type: System.String

Właściwości opcjonalne

BuiltInAccount

Określ nazwę konta komputera do uruchomienia usługi jako. Aby uruchomić usługę, konto musi mieć dostęp do pliku wykonywalnego określonego przez ścieżkę .

Nie należy określać tej właściwości za pomocą właściwości Credential .

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

Poświadczenie

Określ poświadczenia konta do uruchomienia usługi jako. Aby uruchomić usługę, konto musi mieć dostęp do pliku wykonywalnego określonego przez ścieżkę . Zasób automatycznie przyznaje temu kontu prawo "Zaloguj się jako usługa".

Nie należy określać tej właściwości za pomocą właściwości BuiltInAccount .

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

Zależności

Określ nazwy usług, których ta usługa wymaga uruchomienia jako tablicy ciągów.

Type: System.String[]
Default Value: None

Opis

Określ opis usługi jako ciąg. Opis usługi jest wyświetlany w obszarze Zarządzanie komputerem, Usługi.

Type: System.String
Default Value: None

DesktopInteract

Określ, czy usługa może tworzyć lub komunikować się z oknem na pulpicie. Ta właściwość musi być $false taka, jeśli właściwość BuiltInAccount nie jest określona jako LocalSystem.

Wartość domyślna to $false.

Type: System.Boolean
Default Value: false

Nazwa wyświetlana

Określ przyjazną dla człowieka nazwę wyświetlaną usługi jako ciąg.

Type: System.String
Default Value: None

Zapewnienia

Określ, czy usługa powinna istnieć. Aby dodać lub zaktualizować usługę, ustaw tę właściwość na Present. Aby usunąć usługę, ustaw tę właściwość na Absent.

Wartość domyślna to Present.

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

Ścieżka

Określ ścieżkę do pliku wykonywalnego usługi jako ciąg. Ta właściwość jest wymagana, jeśli usługa nie istnieje.

Type: System.String
Default Value: None

StartupTimeout

Określ czas oczekiwania na uruchomienie usługi w milisekundach.

Wartość domyślna to 30000.

Type: System.UInt32
Default Value: 30000

Typ uruchamiania

Określ, jak usługa powinna zachowywać się podczas uruchamiania systemu. Wartość musi być jedną z następujących wartości:

  • Automatic — Usługa jest uruchamiana przez system operacyjny podczas uruchamiania systemu. Jeśli automatycznie uruchomiona usługa zależy od ręcznie uruchomionej usługi, ręcznie uruchomiona usługa jest również uruchamiana automatycznie podczas uruchamiania systemu.
  • Disabled — Usługa jest wyłączona i nie można jej uruchomić przez użytkownika lub aplikację.
  • Manual — Usługa jest uruchamiana tylko ręcznie, przez użytkownika, przy użyciu Menedżera kontroli usług lub przez aplikację.

Jeśli usługa nie istnieje, wartość domyślna to Automatic.

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

Stan

Określ, czy usługa ma być uruchomiona. Wartość musi być jedną z następujących wartości:

  • Running — Zasób uruchamia usługę, jeśli jeszcze nie została uruchomiona.
  • Stopped — Zasób zatrzymuje usługę, jeśli jest uruchomiona.
  • Ignore — Zasób nie uruchamia ani nie zatrzymuje usługi.

Wartość domyślna to Running.

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

TerminateTimeout

Określ czas oczekiwania na zatrzymanie usługi w milisekundach. Wartość domyślna to 30000.

Type: System.UInt32
Default Value: 30000

Przykłady