Zasób zestawu usług DSC

Dotyczy: Windows PowerShell 4.0, Windows PowerShell 5.x

Zasób ServiceSet w Windows PowerShell Desired State Configuration (DSC) udostępnia mechanizm zarządzania usługami w węźle docelowym. Ten zasób jest zasobem złożonym , który wywołuje zasób usługi dla każdej usługi określonej we właściwości Name .

Użyj tego zasobu, jeśli chcesz skonfigurować wiele usług do tego samego stanu.

Uwaga

Ta dokumentacja tego zasobu DSC obejmuje wersję dołączoną do programu PowerShell w wersji 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 zaktualizować dokumentację, zobacz dokumentację referencyjną usługi PSDscResources.

Składnia

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

Właściwości

Właściwość	Opis
Nazwa	Wskazuje nazwy usług. Należy pamiętać, że czasami różni się to od nazw wyświetlanych. Listę usług i ich bieżący stan można uzyskać za pomocą Get-Service polecenia cmdlet .
Typ uruchamiania	Wskazuje typ uruchamiania usług. Wartości dozwolone dla tej właściwości to: Automatyczne, Wyłączone i Ręczne.
BuiltInAccount	Wskazuje konto logowania do użycia dla usług. Wartości dozwolone dla tej właściwości to : LocalService, LocalSystem i NetworkService.
Stan	Wskazuje stan, który chcesz zapewnić dla usług: Zatrzymano lub Uruchomiono.
Poświadczenie	Wskazuje poświadczenia dla konta, w ramach którego zostanie uruchomiony zasób usługi. Tej właściwości i właściwości BuiltinAccount nie można używać razem.

Wspólne właściwości

Właściwość	Opis
Dependson	Wskazuje, że konfiguracja innego zasobu musi zostać uruchomiona przed skonfigurowaniem tego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typ to ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnić	Wskazuje, czy usługi istnieją w systemie. Ustaw tę właściwość na Nieobecny , aby upewnić się, że usługi nie istnieją. Ustawienie go na Wartość Prezent gwarantuje, że usługi docelowe istnieją. Wartość domyślna to Obecny.
PsDscRunAsCredential	Ustawia poświadczenie na potrzeby 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

Poniższa konfiguracja uruchamia usługi "Windows Audio" i "Usług pulpitu zdalnego".

configuration ServiceSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {
        ServiceSet ServiceSetExample
        {
            Name        = @("TermService", "Audiosrv")
            StartupType = "Manual"
            State       = "Running"
        }
    }
}