환경

  • 아티클

개요

컴퓨터 또는 프로세스에 대한 환경 변수를 관리합니다.

구문

Environment [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [Target = [string[]]{ Machine | Process }]
    [Value = [string]]
}

Description

리소스 Environment 를 사용하면 대상에서 환경 변수를 Machine 만들고, 업데이트하고 Process , 제거할 수 있습니다. 경로 형식 환경 변수를 관리하여 환경 변수에서 특정 값이 포함되거나 제거되도록 할 수 있습니다.

요구 사항

없음

키 속성

Name

환경 변수의 이름을 지정합니다.

Type: System.String

선택적 속성

Ensure

환경 변수가 있는지 여부를 지정합니다. 환경 변수가 있는 경우 제거하려면 이 속성을 Absent 지정합니다. 환경 변수가 없는 경우 이 속성을 Present 지정하고 설정된 경우 Value 속성을 적용합니다. 기본값은 Present입니다.

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

경로

환경 변수를 경로 변수로 처리할지 여부를 지정합니다. 그러면 환경 변수에 대한 Ensure 동작이 수정되었습니다.

  • Path가고$true, Ensure가 Present있고, 값이 환경 변수의 현재 값에 포함되지 않은 경우 리소스는 환경 변수의 현재 값에 값을 추가합니다.
  • 경로가 $true있는지 확인하고Absent값이 환경 변수의 현재 값에 포함되면 리소스는 환경 변수의 현재 값에서 값을 제거합니다.
  • 경로가 $false 있고 확인되면 Present리소스는 환경 변수를 값으로 설정합니다.
  • 경로가 $false 있고 확인되면 Absent리소스는 환경 변수를 제거합니다.

기본값은 $false입니다.

Type: System.Boolean
Default Value: false

대상

환경 변수를 구성할 대상을 하나 이상 지정합니다. 유효한 값은 다음과 같습니다.

  • Process
  • Machine

기본적으로 환경 변수는 대상과 Machine 대상 모두에서 Process 구성됩니다.

Type: System.String[]
Accepted Values:
  - Process
  - Machine
Default Value: [Process, Machine]

값

환경 변수의 값을 문자열로 지정합니다. 값이 빈 문자열인지 여부('')는 환경 변수에 대한 Ensure 동작을 수정합니다.

  • 값이 빈 문자열인 경우 Ensure isPresent이고 환경 변수가 있으면 리소스가 환경 변수를 업데이트하지 않습니다.
  • 값이 빈 문자열인 경우 Ensure isPresent이고 환경 변수가 없으면 리소스가 잘못된 작업 예외를 throw합니다.
  • 값이 빈 문자열인 경우 Ensure isAbsent이고 환경 변수가 있으면 리소스가 환경 변수를 제거합니다.

기본값은 빈 문자열입니다.

Type: System.String
Default Value: ''

예제