DSC 보관 리소스

적용 대상: Windows PowerShell 4.0, Windows PowerShell 5.x

Windows PowerShell DSC(필요한 상태 구성)의 보관 리소스는 특정 경로에서 보관 파일(.zip) 파일의 압축을 풀기 위한 메커니즘을 제공합니다.

메모

이 DSC 리소스에 대한 이 설명서에서는 버전 7.2 이전의 PowerShell에 포함된 버전을 다룹니다. PSDscResources 모듈에는 Microsoft에서 공식적으로 지원하는 새 DSC 리소스와 업데이트된 DSC 리소스가 포함되어 있습니다. PSDscResources 모듈은 PowerShell 갤러리에서 사용할 수 있습니다.

자세한 내용 및 업데이트된 설명서는 PSDscResources 참조 설명서참조하세요.

통사론

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

속성

재산	묘사
목적지	보관 콘텐츠가 추출되도록 하려는 위치를 지정합니다.
길	보관 파일의 원본 경로를 지정합니다.
체크섬	두 파일이 같은지 여부를 결정할 때 사용할 형식을 정의합니다. 체크섬 지정하지 않으면 파일 또는 디렉터리 이름만 비교에 사용됩니다. 유효한 값은 다음과 같습니다. SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. 유효성 검사없이 체크섬 지정하면 구성이 실패합니다.
자격 증명	필요한 경우 지정된 보관 경로 및 대상에 액세스할 수 있는 권한이 있는 사용자 계정의 자격 증명입니다.
포스	특정 파일 작업(예: 파일 덮어쓰기 또는 비어 있지 않은 디렉터리 삭제)으로 인해 오류가 발생합니다. Force 속성을 사용하면 이러한 오류가 재정의됩니다. 기본값은 false.
확인	Checksum 속성을 사용하여 보관이 서명과 일치하는지 확인합니다. 유효성 검사없이 체크섬 지정하면 구성이 실패합니다. 체크섬없이 유효성 검사 지정하는 경우 기본적으로 SHA-256체크섬 사용됩니다.

공통 속성

재산	묘사
DependsOn	이 리소스를 구성하기 전에 다른 리소스의 구성을 실행해야 임을 나타냅니다. 예를 들어 먼저 실행하려는 리소스 구성 스크립트 블록의 ID가 ResourceName이고 해당 형식이 ResourceType인 경우 이 속성을 사용하는 구문은 DependsOn = "[ResourceType]ResourceName".
확인	보관의 콘텐츠가 대상있는지 여부를 확인합니다. 콘텐츠가 있는지 확인하려면 이 속성을 Present 설정합니다. Absent 설정하여 존재하지 않도록 합니다. 기본값은 Present.
PsDscRunAsCredential	전체 리소스를 실행하기 위한 자격 증명을 로 설정합니다.

메모

다른 자격 증명의 컨텍스트에서 모든 DSC 리소스를 실행할 수 있도록 PsDscRunAsCredential 공용 속성이 WMF 5.0에 추가되었습니다. 자세한 내용은 DSC 리소스자격 증명 사용 참조하세요.

본보기

다음 예제에서는 보관 리소스를 사용하여 Test.zip 호출된 보관 파일의 내용이 존재하고 지정된 대상에서 추출되고 권한이 부여되었는지 확인하는 방법을 보여 줍니다.

Archive ArchiveExample {
    Ensure = "Present"
    Path = "C:\Users\Public\Documents\Test.zip"
    Destination = "C:\Users\Public\Documents\ExtractionPath"
}