DSC 보관 리소스DSC Archive Resource

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

Windows PowerShell DSC(필요한 상태 구성)의 보관 리소스는 특정 경로에서 보관(.zip) 파일의 압축을 푸는 메커니즘을 제공합니다.The Archive resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to unpack archive (.zip) files at a specific path.

구문Syntax

Archive [string] #ResourceName
{
    Destination = [string]
    Path = [string]
    [ Checksum = [string] { CreatedDate | ModifiedDate | SHA-1 | SHA-256 | SHA-512 } ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present } ]
    [ Force = [bool] ]
    [ Validate = [bool] ]
}

속성Properties

속성Property 설명Description
대상Destination 보관 파일 내용을 추출해 놓을 위치를 지정합니다.Specifies the location where you want to ensure the archive contents are extracted.
경로Path 보관 파일의 원본 경로를 지정합니다.Specifies the source path of the archive file.
ChecksumChecksum 두 파일이 동일한 것인지 결정할 때 사용할 형식을 정의합니다.Defines the type to use when determining whether two files are the same. __Checksum__을 지정하지 않은 경우 비교에 파일 또는 디렉터리 이름만 사용됩니다.If Checksum is not specified, only the file or directory name is used for comparison. 유효한 값에는 SHA-1, SHA-256, SHA-512, createdDate, modifiedDate, none(기본값)이 있습니다.Valid values include: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate, none (default). Validate 없이 __Checksum__을 지정하는 경우, 구성이 실패합니다.If you specify Checksum without Validate, the configuration will fail.
EnsureEnsure 보관 파일의 내용이 __Destination__에 있는지 확인할지 여부를 결정합니다.Determines whether to check if the content of the archive exists at the Destination. 내용이 있도록 하려면 이 속성을 __Present__으로 설정합니다.Set this property to Present to ensure the contents exist. 내용이 없도록 하려면 이 속성을 __Absent__으로 설정합니다.Set it to Absent to ensure they do not exist. 기본값은 __Present__입니다.The default value is Present.
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".
유효성 검사Validate 보관 파일이 서명과 일치하는지 여부를 결정하려면 체크섬 속성을 사용합니다.Uses the Checksum property to determine if the archive matches the signature. 유효성 검사 없이 체크섬을 지정하면 구성이 실패합니다.If you specify Checksum without Validate, the configuration will fail. 체크섬 없이 유효성 검사를 지정하면 기본적으로 SHA-256 체크섬이 사용됩니다.If you specify Validate without Checksum, a SHA-256 checksum is used by default.
ForceForce 특정 파일 작업(예: 파일 덮어쓰기나 비어 있지 않은 디렉터리 삭제)을 수행하면 오류가 발생합니다.Certain file operations (such as overwriting a file or deleting a directory that is not empty) will result in an error. Force 속성을 사용하면 이러한 오류가 무시됩니다.Using the Force property overrides such errors. 기본값은 False입니다.The default value is False.

예제Example

다음 예제에서는 보관 리소스를 사용하여 Test.zip이라는 보관 파일의 내용이 존재하고 지정된 대상에 압축이 풀리도록 하는 방법을 보여줍니다.The following example shows how to use the Archive resource to ensure that the contents of an archive file called Test.zip exist and are extracted at a given destination.

Archive ArchiveExample {
    Ensure = "Present"  # You can also set Ensure to "Absent"
    Path = "C:\Users\Public\Documents\Test.zip"
    Destination = "C:\Users\Public\Documents\ExtractionPath"
}