DSC 서비스 리소스DSC Service Resource

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

Windows PowerShell DSC(필요한 상태 구성)의 서비스 리소스에서는 대상 노드에 있는 서비스를 관리하는 메커니즘을 제공합니다.The Service resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node.

구문Syntax

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

속성Properties

속성Property 설명Description
이름Name 서비스 이름을 나타냅니다.Indicates the service name. 이 속성은 경우에 따라 표시 이름과 다릅니다.Note that sometimes this is different from the display name. Get-Service cmdlet으로 서비스 목록과 현재 상태를 가져올 수 있습니다.You can get a list of the services and their current state with the Get-Service cmdlet.
BuiltInAccountBuiltInAccount 서비스에 사용할 로그인 계정을 나타냅니다.Indicates the sign-in account to use for the service. 이 속성에 허용된 값은 LocalService, LocalSystem, 및 NetworkService입니다.The values that are allowed for this property are: LocalService, LocalSystem, and NetworkService.
자격 증명Credential 서비스가 실행되는 계정에 대한 자격 증명을 나타냅니다.Indicates credentials for the account that the service 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".
StartupTypeStartupType 서비스의 시작 유형을 나타냅니다.Indicates the startup type for the service. 이 속성에 허용된 값은 Automatic, DisabledManual입니다.The values that are allowed for this property are: Automatic, Disabled, and Manual
StateState 서비스에 대해 확인하려는 상태를 나타냅니다.Indicates the state you want to ensure for the service.
설명Description 대상 서비스에 대한 설명을 나타냅니다.Indicates the description of the target service.
DisplayNameDisplayName 대상 서비스에 대한 표시 이름을 나타냅니다.Indicates the display name of the target service.
EnsureEnsure 대상 서비스가 시스템에 있는지 여부를 지정합니다.Indicates whether the target service exists on the system. 대상 서비스가 존재하지 않도록 하려면 이 속성을 Absent로 설정합니다.Set this property to Absent to ensure that the target service does not exist. 대상 서비스가 존재하도록 하려면 이 속성을 Present(기본값)로 설정합니다.Setting it to Present (the default value) ensures that target service exists.
경로Path 새 서비스에 대한 이진 파일의 경로를 나타냅니다.Indicates the path to the binary file for a new service.

예제Example

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {

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