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"
}
}
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla