Linux용 DSC nxPackage 리소스DSC for Linux nxPackage Resource

PowerShell DSC(필요한 상태 구성)의 nxPackage 리소스에서는 Linux 노드에 있는 패키지를 관리하는 메커니즘을 제공합니다.The nxPackage resource in PowerShell Desired State Configuration (DSC) provides a mechanism to manage packages on a Linux node.

구문Syntax

nxPackage <string> #ResourceName
{
    Name = <string>
    [ Ensure = <string> { Absent | Present }  ]
    [ PackageManager = <string> { Yum | Apt | Zypper } ]
    [ PackageGroup = <bool>]
    [ Arguments = <string> ]
    [ ReturnCode = <uint32> ]
    [ LogPath = <string> ]
    [ DependsOn = <string[]> ]

}

속성Properties

속성Property 설명Description
이름Name 특정 상태를 확인하려는 패키지의 이름입니다.The name of the package for which you want to ensure a specific state.
EnsureEnsure 해당 패키지가 존재하는지를 확인할지 여부를 결정합니다.Determines whether to check if the package exists. 해당 패키지가 존재하도록 하려면 이 속성을 "Present"으로 설정합니다.Set this property to "Present" to ensure the package exists. 해당 패키지가 존재하지 않도록 하려면 이 속성을 "Absent"으로 설정합니다.Set it to "Absent" to ensure the package does not exist. 기본값은 "Present"입니다.The default value is "Present".
PackageManagerPackageManager 지원되는 값은 "yum", "apt" 및 "zypper"입니다.Supported values are "yum", "apt", and "zypper". 패키지를 설치할 때 사용할 패키지 관리자를 지정합니다.Specifies the package manager to use when installing packages. FilePath가 지정되면, 제공된 경로가 패키지를 설치하는 데 사용됩니다.If FilePath is specified, the provided path will be used to install the package. 지정되지 않으면 패키지 관리자를 사용하여 미리 구성된 리포지토리에서 패키지를 설치하게 됩니다.Otherwise, a Package Manager will be used to install the package from a pre-configured repository. PackageManagerFilePath가 모두 제공되지 않으면, 시스템에 대한 기본 패키지 관리자가 사용됩니다.If neither PackageManager nor FilePath are provided, the default package manager for the system will be used.
FilePathFilePath 패키지가 있는 파일 경로The file path where the package resides
PackageGroupPackageGroup $true일 경우, NamePackageManager와 함께 사용할 패키지 그룹의 이름이 될 것으로 예상됩니다.If $true, the Name is expected to be the name of a package group for use with a PackageManager. FilePath를 제공하면 PacakgeGroup이 유효하지 않습니다.PacakgeGroup is not valid when providing a FilePath.
인수Arguments 제공된 그대로 패키지에 전달되는 인수 문자열입니다.A string of arguments that will be passed to the package exactly as provided.
ReturnCodeReturnCode 예상된 반환 코드입니다.The expected return code. 실제 반환 코드가 여기에 제공된 예상 값과 일치하지 않는 경우 구성에서 오류를 반환하게 됩니다.If the actual return code does not match the expected value provided here, the configuration will return an error.
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".

예제Example

다음 예제에서는 "Yum" 패키지 관리자를 사용하여 "httpd"라는 패키지가 Linux 컴퓨터에 설치되어 있는지 확인합니다.The following example ensures that the package named "httpd" is installed on a Linux computer, using the “Yum” package manager.

Import-DSCResource -Module nx

Node $node {
nxPackage httpd
{
    Name = "httpd"
    Ensure = "Present"
    PackageManager = "Yum"
}
}