Linux nxEnvironment 리소스용 DSCDSC for Linux nxEnvironment Resource

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

구문Syntax

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

}

속성Properties

속성Property 설명Description
이름Name 특정 상태를 확인하려는 환경 변수의 이름을 나타냅니다.Indicates the name of the environment variable for which you want to ensure a specific state.
ValueValue 환경 변수에 할당할 값입니다.The value to assign to the environment variable.
EnsureEnsure 해당 변수가 존재하는지를 확인할지 여부를 결정합니다.Determines whether to check if the variable exists. 변수가 존재하도록 하려면 이 속성을 "Present"으로 설정합니다.Set this property to "Present" to ensure the variable exists. 변수가 존재하지 않도록 하려면 이 속성을 "Absent"으로 설정합니다.Set it to "Absent" to ensure the variable does not exist. 기본값은 "Present"입니다.The default value is "Present".
경로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. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 IDResourceName이고 해당 형식이 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".

추가 정보Additional Information

  • Path가 없거나 $false로 설정되어 있으면, 환경 변수는 /etc/environment에서 관리됩니다.If Path is absent or set to $false, environment variables are managed in /etc/environment. 프로그램 또는 스크립트가 구성을 통해 관리되는 환경 변수에 액세스하도록 /etc/environment 파일을 소싱해야 할 수도 있습니다.Your programs or scripts may require configuration to source the /etc/environment file to access the managed environment variables.
  • Path$true로 설정된 경우, 환경 변수는 /etc/profile.d/DSCenvironment.sh 파일에서 관리됩니다.If Path is set to $true, the environment variable is managed in the file /etc/profile.d/DSCenvironment.sh. 이 파일은 존재하지 않는 경우 만들어집니다.This file will be created if it does not exist. Ensure가 "Absent"으로 설정되어 있고, Path$true로 설정되어 있는 경우, 기존 환경 변수는 다른 파일에서는 제거되지 않고 /etc/profile.d/DSCenvironment.sh에서만 제거됩니다.If Ensure is set to "Absent" and Path is set to $true, an existing environment variable will only be removed from /etc/profile.d/DSCenvironment.sh and not from other files.

예제Example

다음 예제에서는 nxEnvironment 리소스를 사용하여 TestEnvironmentVariable이 존재하고 "Test-Value" 값을 갖도록 하는 방법을 보여 줍니다.The following example shows how to use the nxEnvironment resource to ensure that TestEnvironmentVariable is present and has the value "Test-Value". TestEnvironmentVariable이 존재하지 않을 경우, 자동으로 만들어집니다.If TestEnvironmentVariable is not present, it will be created.

Import-DSCResource -Module nx


nxEnvironment EnvironmentExample
{
    Ensure = “Present”
    Name = “TestEnvironmentVariable”
    Value = “TestValue”
}