Zasób zasób serviceset DSCDSC ServiceSet Resource

Dotyczy: Windows PowerShell 4,0, Windows PowerShell 5. xApplies To: Windows PowerShell 4.0, Windows PowerShell 5.x

Zasób zasób serviceset w konfiguracji żądanego stanu (DSC) programu Windows PowerShell zapewnia mechanizm zarządzania usługami w węźle docelowym.The ServiceSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node. 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 .This resource is a composite resource that calls the Service resource for each service specified in the Name property.

Użyj tego zasobu, jeśli chcesz skonfigurować wiele usług w tym samym stanie.Use this resource when you want to configure a number of services to the same state.

SkładniaSyntax

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ściProperties

WłaściwośćProperty OpisDescription
NazwaName Wskazuje nazwy usług.Indicates the service names. Należy pamiętać, że czasami różni się to od nazw wyświetlanych.Note that sometimes this is different from the display names. Za pomocą polecenia cmdlet można uzyskać listę usług i ich bieżący stan Get-Service .You can get a list of the services and their current state with the Get-Service cmdlet.
StartupTypeStartupType Wskazuje typ uruchamiania usług.Indicates the startup type for the services. Wartości dozwolone dla tej właściwości to: Automatyczne, wyłączonei Ręczne.The values that are allowed for this property are: Automatic, Disabled, and Manual.
BuiltInAccountBuiltInAccount Wskazuje konto logowania, które ma być używane dla usług.Indicates the sign-in account to use for the services. Wartości dozwolone dla tej właściwości to: LocalService, LocalSystemi NetworkService.The values that are allowed for this property are: LocalService, LocalSystem, and NetworkService.
StanState Wskazuje stan, który ma być używany przez usługi: zatrzymana lub uruchomiona.Indicates the state you want to ensure for the services: Stopped or Running.
PoświadczenieCredential Wskazuje poświadczenia konta, w ramach którego zostanie uruchomiony zasób usługi.Indicates credentials for the account that the service resource will run under. Ta właściwość i Właściwość BuiltinAccount nie mogą być używane razem.This property and the BuiltinAccount property cannot be used together.

Wspólne właściwościCommon properties

WłaściwośćProperty OpisDescription
DependsOnDependsOn Wskazuje, że konfiguracja innego zasobu musi być uruchomiona przed skonfigurowaniem tego zasobu.Indicates that the configuration of another resource must run before this resource is configured. Na przykład, jeśli identyfikator bloku skryptu konfiguracji zasobu, który ma zostać uruchomiony jako pierwszy jest resourceName, a jego typ to ResourceType, Składnia służąca do użycia tej właściwości to DependsOn = "[ResourceType]ResourceName" .For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
Upewnij się żeEnsure Wskazuje, czy usługi istnieją w systemie.Indicates whether the services exist on the system. Ustaw tę właściwość na Brak , aby upewnić się, że usługi nie istnieją.Set this property to Absent to ensure that the services do not exist. Ustawienie tej opcji na obecność gwarantuje, że usługi docelowe istnieją.Setting it to Present ensures that target services exist. Wartość domyślna jest obecna.The default value is Present.
PsDscRunAsCredentialPsDscRunAsCredential Ustawia poświadczenia do uruchamiania całego zasobu jako.Sets the credential for running the entire resource as.

Uwaga

Właściwość PsDscRunAsCredential Common została dodana w programie WMF 5,0, aby umożliwić uruchamianie dowolnego zasobu DSC w kontekście innych poświadczeń.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Aby uzyskać więcej informacji, zobacz Korzystanie z poświadczeń z zasobami DSC.For more information, see Use Credentials with DSC Resources.

PrzykładExample

Poniższa konfiguracja umożliwia uruchomienie usług "Windows Audio" i "Usługi pulpitu zdalnego".The following configuration starts the "Windows Audio" and "Remote Desktop Services" services.

configuration ServiceSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {
        ServiceSet ServiceSetExample
        {
            Name        = @("TermService", "Audiosrv")
            StartupType = "Manual"
            State       = "Running"
        }
    }
}