Zasób usługi DSC

Dotyczy: Windows PowerShell 4.0, Windows PowerShell 5.x

Zasób usługi w Windows PowerShell Desired State Configuration (DSC) udostępnia mechanizm zarządzania usługami w węźle docelowym.

Uwaga

Ta dokumentacja tego zasobu DSC obejmuje wersję dołączoną do programu PowerShell przed wersją 7.2. Moduł PSDscResources zawiera nowe i zaktualizowane zasoby DSC, które są oficjalnie obsługiwane przez firmę Microsoft. Moduł PSDscResources jest dostępny w Galeria programu PowerShell.

Aby uzyskać więcej informacji i zaktualizowaną dokumentację, zobacz dokumentację referencyjną psDscResources.

Składnia

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

Właściwości

Właściwość	Opis
Nazwa	Wskazuje nazwę usługi. Należy pamiętać, że czasami różni się to od nazwy wyświetlanej. Listę usług i ich bieżący stan można uzyskać za Get-Service pomocą polecenia cmdlet .
BuiltInAccount	Wskazuje konto logowania do użycia dla usługi. Wartości dozwolone dla tej właściwości to : LocalService, LocalSystem i NetworkService.
Poświadczenie	Wskazuje poświadczenia dla konta, w ramach którego będzie działać usługa. Tej właściwości i właściwości BuiltinAccount nie można używać razem.
Typ uruchomienia	Wskazuje typ uruchamiania usługi. Wartości dozwolone dla tej właściwości to: Automatyczne, Wyłączone i Ręczne.
Stan	Wskazuje stan, który chcesz zapewnić dla usługi. Wartości to: Uruchomiono lub Zatrzymano.
Zależności	Tablica nazw zależności, które powinna mieć usługa.
Opis	Wskazuje opis usługi docelowej.
Nazwa wyświetlana	Wskazuje nazwę wyświetlaną usługi docelowej.
Ścieżka	Wskazuje ścieżkę do pliku binarnego dla nowej usługi.

Wspólne właściwości

Właściwość	Opis
Dependson	Wskazuje, że przed skonfigurowaniem tego zasobu należy uruchomić konfigurację innego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typem jest ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnić	Wskazuje, czy usługa docelowa istnieje w systemie. Ustaw tę właściwość na Brak , aby upewnić się, że usługa docelowa nie istnieje. Ustawienie wartości Present gwarantuje, że usługa docelowa istnieje. Wartość domyślna to Present (Obecny).
PsDscRunAsCredential	Ustawia poświadczenie do uruchamiania całego zasobu jako.

Uwaga

Właściwość pospolita PsDscRunAsCredential została dodana w programie WMF 5.0, aby umożliwić uruchamianie dowolnego zasobu DSC w kontekście innych poświadczeń. Aby uzyskać więcej informacji, zobacz Use Credentials with DSC Resources (Używanie poświadczeń z zasobami DSC).

Przykład

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

        Service ServiceExample
        {
            Name        = "TermService"
            StartupType = "Manual"
            State       = "Running"
        }
    }
}