DSC 환경 리소스DSC Environment Resource

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

PowerShell DSC(필요한 상태 구성)의 Environment 리소스에서는 시스템 환경 변수를 관리하는 메커니즘을 제공합니다.The Environment resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage system environment variables.

구문Syntax

Environment [string] #ResourceName
{
    Name = [string]
    [ Ensure = [string] { Absent | Present }  ]
    [ Path = [bool] ]
    [ DependsOn = [string[]] ]
    [ Value = [string] ]
}

속성Properties

속성Property 설명Description
이름Name 특정 상태를 확인하려는 환경 변수의 이름을 나타냅니다.Indicates the name of the environment variable for which you want to ensure a specific state.
EnsureEnsure 변수가 있는지 여부를 나타냅니다.Indicates if a variable exists. 변수가 없는 경우 환경 변수를 만들거나 변수가 이미 있는 경우 그 값이 Value 속성을 통해 제공된 값과 일치하는지 확인하려면 이 속성을 __있음__으로 설정합니다.Set this property to Present to create the environment variable if it does not exist or to ensure that its value matches what is provided through the Value property if the variable already exists. 변수가 존재하는 경우 변수를 삭제하려면 이 속성을 __없음__으로 설정합니다.Set it to Absent to delete the variable if it exists.
경로Path 구성 중인 환경 변수를 정의합니다.Defines the environment variable that is being configured. 변수가 Path 변수이면 이 속성을 __$true__로 설정하고, 그렇지 않으면 __$false__로 설정합니다.Set this property to $true if the variable is the Path variable; otherwise, set it to $false. 기본값은 __$false__입니다.The default is $false. 구성되고 있는 변수가 Path 변수라면, Value 속성을 통해 제공된 값은 기존 값에 추가됩니다.If the variable being configured is the Path variable, the value provided through the Value property will be appended to the existing value.
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".
ValueValue 환경 변수에 할당할 값입니다.The value to assign to the environment variable.

예제Example

다음 예제에서는 __TestEnvironmentVariable__이 있고 그 값이 __TestValue__인지 확인합니다.The following example ensures that TestEnvironmentVariable is present and it has the value TestValue. 없을 경우 만듭니다.If it is not present, it creates it.

Environment EnvironmentExample
{
    Ensure = "Present"  # You can also set Ensure to "Absent"
    Name = "TestEnvironmentVariable"
    Value = "TestValue"
}