서비스

아티클
05/05/2023

개요

Windows 서비스를 관리합니다.

구문

Service [String] #ResourceName
{
    Name = [string]
    [BuiltInAccount = [string]{ LocalService | LocalSystem | NetworkService }]
    [Credential = [PSCredential]]
    [Dependencies = [string[]]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [DesktopInteract = [bool]]
    [DisplayName = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [string]]
    [PsDscRunAsCredential = [PSCredential]]
    [StartupTimeout = [UInt32]]
    [StartupType = [string]{ Automatic | Disabled | Manual }]
    [State = [string]{ Ignore | Running | Stopped }]
    [TerminateTimeout = [UInt32]]
}

Description

리소스 Service 를 사용하면 서비스를 추가, 업데이트 및 제거할 수 있습니다.

요구 사항

없음

키 속성

Name

서비스 이름을 문자열로 지정합니다.

참고

경우에 따라 이 값이 표시 이름과 다릅니다. Get-Service cmdlet으로 서비스 목록과 현재 상태를 가져올 수 있습니다.

Type: System.String

선택적 속성

BuiltInAccount

서비스를 실행할 컴퓨터 계정의 이름을 지정합니다. 서비스를 시작하려면 계정에 Path 로 지정된 실행 파일에 액세스할 수 있어야 합니다.

자격 증명 속성을 사용하여 이 속성을 지정하지 마세요.

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

자격 증명

서비스를 실행할 계정의 자격 증명을 지정합니다. 서비스를 시작하려면 계정에 Path 로 지정된 실행 파일에 대한 액세스 권한이 있어야 합니다. 리소스는 이 계정에 "서비스로 로그온" 권한을 자동으로 부여합니다.

BuiltInAccount 속성을 사용하여 이 속성을 지정하지 마세요.

Type: System.Management.Automation.PSCredential
Default Value: None

종속성

이 서비스가 문자열 배열로 실행되어야 하는 서비스의 이름을 지정합니다.

Type: System.String[]
Default Value: None

설명

서비스에 대한 설명을 문자열로 지정합니다. 서비스 설명은 컴퓨터 관리, 서비스에 표시됩니다.

Type: System.String
Default Value: None

DesktopInteract

서비스가 바탕 화면의 창을 만들거나 통신할 수 있는지 여부를 지정합니다. 이 속성은 $falseBuiltInAccount 가 로 지정 LocalSystem되지 않은 경우여야 합니다.

기본값은 $false입니다.

Type: System.Boolean
Default Value: false

DisplayName

서비스의 친숙한 표시 이름을 문자열로 지정합니다.

Type: System.String
Default Value: None

Ensure

서비스가 있는지 여부를 지정합니다. 서비스를 추가하거나 업데이트하려면 이 속성을 .로 Present설정합니다. 서비스를 제거하려면 이 속성을 .로 Absent설정합니다.

기본값은 Present입니다.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

경로

서비스의 실행 파일 경로를 문자열로 지정합니다. 이 속성은 서비스가 없는 경우 필요합니다.

Type: System.String
Default Value: None

StartupTimeout

서비스가 시작될 때까지 대기하는 시간을 밀리초 단위로 지정합니다.

기본값은 30000입니다.

Type: System.UInt32
Default Value: 30000

StartupType

시스템 시작 시 서비스가 작동하는 방식을 지정합니다. 값은 다음 중 하나여야 합니다.

Automatic - 서비스가 시스템 시작 시 운영 체제에 의해 시작됩니다. 자동으로 시작된 서비스가 수동으로 시작된 서비스에 따라 달라지는 경우 수동으로 시작된 서비스도 시스템 시작 시 자동으로 시작됩니다.
Disabled - 서비스를 사용할 수 없으며 사용자 또는 애플리케이션에서 시작할 수 없습니다.
Manual - 서비스는 사용자가 서비스 제어 관리자를 사용하거나 애플리케이션에서 수동으로만 시작합니다.

서비스가 없으면 기본값은 .입니다 Automatic.

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

시스템 상태

서비스를 실행할지 여부를 지정합니다. 값은 다음 중 하나여야 합니다.

Running - 리소스가 아직 시작되지 않은 경우 서비스를 시작합니다.
Stopped - 실행 중인 경우 리소스가 서비스를 중지합니다.
Ignore - 리소스가 서비스를 시작하거나 중지하지 않습니다.

기본값은 Running입니다.

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

TerminateTimeout

서비스가 중지되는 시간(밀리초)을 지정합니다. 기본값은 30000입니다.

Type: System.UInt32
Default Value: 30000

서비스

개요

구문