WindowsProcess

아티클
05/05/2023

개요

Windows 프로세스를 시작하거나 중지합니다.

구문

WindowsProcess [String] #ResourceName
{
    Arguments = [string]
    Path = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [PsDscRunAsCredential = [PSCredential]]
    [StandardErrorPath = [string]]
    [StandardInputPath = [string]]
    [StandardOutputPath = [string]]
    [WorkingDirectory = [string]]
}

Description

리소스 WindowsProcess 를 사용하면 프로세스가 실행 중인지 여부를 확인할 수 있습니다.

요구 사항

없음

키 속성

인수

문자열로 시작할 때 프로세스에 전달할 인수의 전체 목록을 지정합니다. 프로세스에 인수가 필요하지 않은 경우 이 속성을 빈 문자열('')로 설정합니다.

Type: System.String

경로

프로세스의 실행 파일 경로를 지정합니다. 환경 변수를 통해 PATH 파일에 액세스할 수 있는 경우 이 속성을 실행 파일의 이름으로 설정할 수 있습니다. 그렇지 않으면 이 속성을 파일의 전체 경로로 설정합니다. 상대 경로는 지원되지 않습니다.

Type: System.String

선택적 속성

자격 증명

프로세스를 실행할 계정의 자격 증명을 지정합니다.

이 속성을 로컬 시스템 계정으로 설정하면 StandardOutputPath, StandardInputPath 또는 WorkingDirectory 속성을 설정할 수 없습니다. 이렇게 하면 리소스가 잘못된 인수 예외를 throw합니다.

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

Ensure

프로세스를 실행할지 여부를 지정합니다. 실행되고 있지 않은 경우 프로세스를 시작하도록 Present 이 속성을 설정합니다. 실행 중인 경우 프로세스를 중지하도록 Absent 이 속성을 설정합니다.

기본값은 Present입니다.

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

StandardErrorPath

프로세스에서 표준 오류 스트림을 쓸 파일의 전체 경로를 지정합니다. 상대 경로는 지원되지 않습니다. 파일이 있으면 덮어씁니다.

Ensure 속성을 .로 설정할 때 이 속성을 Absent설정하지 마세요. 이렇게 하면 리소스가 잘못된 인수 예외를 throw합니다.

Type: System.String
Default Value: None

StandardInputPath

프로세스가 표준 입력 스트림으로 읽을 파일의 전체 경로를 지정합니다. 상대 경로는 지원되지 않습니다.

Ensure 속성을 로컬 시스템 계정으로 설정하거나 자격 증명 속성을 Absent 설정할 때는 이 속성을 설정하지 마세요. 이렇게 하면 리소스가 잘못된 인수 예외를 throw합니다.

Type: System.String
Default Value: None

StandardOutputPath

프로세스에서 표준 출력 스트림을 쓸 파일의 전체 경로를 지정합니다. 상대 경로는 지원되지 않습니다. 파일이 있으면 덮어씁니다.

Type: System.String
Default Value: None

시작 위치

프로세스의 작업 디렉터리에 대한 폴더의 전체 경로를 지정합니다. 상대 경로는 지원되지 않습니다.

Type: System.String
Default Value: None

읽기 전용 속성

HandleCount

프로세스에서 연 핸들 수입니다.

Type: System.Int32
Behavior: Read

NonPagedMemorySize

프로세스에 할당된 페이지가 없는 메모리의 양(바이트)입니다.

Type: System.UInt64
Behavior: Read

PagedMemorySize

프로세스에 할당된 페이징된 메모리 양(바이트)입니다.

Type: System.UInt64
Behavior: Read

ProcessCount

실행 중인 지정된 프로세스의 인스턴스 수입니다.

Type: System.Int32
Behavior: Read

ProcessId

프로세스의 고유 식별자입니다.

Type: System.Int32
Behavior: Read

VirtualMemorySize

프로세스에 할당된 가상 메모리 양(바이트)입니다.

Type: System.UInt64
Behavior: Read