DSC WindowsPackageCab 리소스DSC WindowsPackageCab Resource

적용 대상: Windows PowerShell 5.1 이상Applies To: Windows PowerShell 5.1 and later

Windows PowerShell DSC(Desired State Configuration)의 WindowsPackageCab 리소스는 대상 노드에서 Windows 캐비닛(.cab) 패키지를 설치하거나 제거하는 메커니즘을 제공합니다.The WindowsPackageCab resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to install or uninstall Windows cabinet (.cab) packages on a target node.

대상 노드에는 DISM PowerShell 모듈이 설치되어 있어야 합니다.The target node must have the DISM PowerShell module installed. 자세한 내용은 Windows PowerShell에서 DISM 사용을 참조하세요.For information, see Use DISM in Windows PowerShell.

구문Syntax

{
    Name = [string]
    Ensure = [string] { Absent | Present }
    SourcePath = [string]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
}

속성Properties

속성Property 설명Description
이름Name 특정 상태가 되게 할 패키지의 이름을 나타냅니다.Indicates the name of the package for you want to ensure a specific state.
EnsureEnsure 패키지가 설치되어 있는지 여부를 나타냅니다.Indicates if the package is installed. 패키지가 설치되어 있지 않도록 하려면(또는 설치되어 있다면 패키지를 제거) 이 속성을 "Absent"으로 설정합니다.Set this property to "Absent" to ensure the package is not installed (or uninstall the package if it is installed). 패키지가 설치되어 있도록 하려면 이 속성을 "Present"(기본값)으로 설정합니다.Set it to "Present" (the default value) to ensure the package is installed.
경로Path 패키지가 있는 경로 나타냅니다.Indicates the path where the package resides.
LogPathLogPath 패키지를 설치하거나 제거하기 위해 공급자가 로그 파일을 저장하도록 하려는 전체 경로를 나타냅니다.Indicates the full path where you want the provider to save a log file to install or uninstall the package.
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"``.

예제Example

다음 예제 구성에서는 입력 매개 변수를 사용하며 $Name 매개 변수로 지정된 .cab 파일이 설치되어 있는지를 확인합니다.The following example configuration takes input parameters, and ensures that the .cab file specified by the $Name parameter is installed.

Configuration Sample_WindowsPackageCab
{
    param
    (
        [Parameter (Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Name,

        [Parameter (Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $SourcePath,

        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $LogPath
    )

    Import-DscResource -ModuleName 'PSDscResources'

    WindowsPackageCab WindowsPackageCab1
    {
        Name = $Name
        Ensure = 'Present'
        SourcePath = $SourcePath
        LogPath = $LogPath
    }
}