Share via

ServiceSet

  • Artykuł

Streszczenie

Zarządzanie wieloma usługami przy użyciu typowych ustawień.

Składnia

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

Opis

ServiceSet to zasób złożony, który ułatwia zarządzanie wieloma usługami jednocześnie przy użyciu konfiguracji udostępnionych, ale ograniczonych. Ten zasób może aktualizować lub usuwać tylko istniejące usługi. Nie może tworzyć usług. Aby uzyskać większą kontrolę nad konfiguracją usług, zobacz Zasób usługi.

Ważne

Zasoby złożone nie działają z programem Invoke-DscResource. Ten zasób jest dostępny tylko wewnątrz Configuration definicji.

Wymagania

Brak.

Właściwości

Kluczowe właściwości

Nazwa

Określ nazwy usług jako tablicę ciągów.

Może się to różnić od nazwy wyświetlanej usługi. Aby pobrać listę wszystkich usług z ich nazwami i bieżącymi stanami, użyj Get-Service polecenia cmdlet .

Type: System.String[]
Behavior: Key

Właściwości opcjonalne

BuiltInAccount

Określ nazwę konta komputera do uruchomienia usługi jako. Aby można było uruchomić usługę, konto musi mieć dostęp do pliku wykonywalnego każdej usługi.

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 dla konta do uruchamiania usług jako. Aby można było uruchomić usługę, konto musi mieć dostęp do pliku wykonywalnego każdej usługi. 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

Zapewnienia

Określ, czy usługi powinny istnieć. Aby dodać lub zaktualizować usługę, ustaw tę właściwość na Presentwartość . Aby usunąć usługę, ustaw tę właściwość na Absentwartość .

Wartość domyślna to Present.

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

Typ uruchomienia

Określ sposób działania usług 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, usługa ręcznie uruchomiona 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 sterowania usługami 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ługi powinny być uruchamiane. Wartość musi być jedną z następujących wartości:

  • Running — Zasób uruchamia usługę, jeśli nie została jeszcze 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

Przykłady