DSC ServiceSet 리소스DSC ServiceSet Resource

적용 대상: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

Windows PowerShell DSC(필요한 상태 구성)의 ServiceSet 리소스에서는 대상 노드에 있는 서비스를 관리하는 메커니즘을 제공합니다.The ServiceSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node. 이 리소스는 Name 속성에 지정된 각 서비스에 대해 서비스 리소스를 호출하는 복합 리소스입니다.This resource is a composite resource that calls the Service resource for each service specified in the Name property.

여러 서비스를 동일한 상태로 구성하려는 경우 이 리소스를 사용합니다.Use this resource when you want to configure a number of services to the same state.

구문Syntax

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

}

속성Properties

속성Property 설명Description
이름Name 서비스 이름을 나타냅니다.Indicates the service names. 이 속성은 경우에 따라 표시 이름과 다릅니다.Note that sometimes this is different from the display names. Get-Service cmdlet으로 서비스 목록과 현재 상태를 가져올 수 있습니다.You can get a list of the services and their current state with the Get-Service cmdlet.
StartupTypeStartupType 서비스의 시작 유형을 나타냅니다.Indicates the startup type for the service. 이 속성에 허용된 값은 Automatic, DisabledManual입니다.The values that are allowed for this property are: Automatic, Disabled, and Manual
BuiltInAccountBuiltInAccount 서비스에 사용할 로그인 계정을 나타냅니다.Indicates the sign-in account to use for the services. 이 속성에 허용된 값은 LocalService, LocalSystem, 및 NetworkService입니다.The values that are allowed for this property are: LocalService, LocalSystem, and NetworkService.
StateState 서비스에 대해 확인하려는 상태 즉, 중지됨 또는 실행 중을 나타냅니다.Indicates the state you want to ensure for the services: Stopped or Running.
EnsureEnsure 서비스가 시스템에 있는지 여부를 지정합니다.Indicates whether the services exist on the system. 서비스가 존재하지 않도록 하려면 이 속성을 Absent로 설정합니다.Set this property to Absent to ensure that the services do not exist. 서비스가 존재하도록 하려면 이 속성을 Present(기본값)로 설정합니다.Setting it to Present (the default value) ensures that target services exist.
자격 증명Credential 서비스 리소스가 실행될 계정에 대한 자격 증명을 나타냅니다.Indicates credentials for the account that the service resource will run under. 이 속성과 BuiltinAccount 속성은 함께 사용할 수 없습니다.This property and the BuiltinAccount property cannot be used together.
DependsOnDependsOn 이 리소스를 구성하려면 먼저 다른 리소스의 구성을 실행해야 함을 나타냅니다.Indicates that the configuration of another resource must run before this resource is configured. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 ID가 ResourceName이고 해당 형식이 ResourceType일 경우, 이 속성을 사용하기 위한 구문은 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".

예제Example

다음 구성에서는 "Windows 오디오" 및 "원격 데스크톱 서비스" 서비스를 시작합니다.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"
        }
    }
}