다음을 통해 공유

보관

  • 아티클

개요

보관 파일.zip의 내용을 확장하거나 제거합니다.

구문

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

Description

리소스 Archive 를 사용하면 보관 파일.zip의 확장된 콘텐츠를 멱등하게 관리할 수 있습니다. 보관 파일의 확장된 콘텐츠가 최신 상태인지 또는 시스템에서 제거되었는지 확인할 수 있습니다.

요구 사항

  • System.IO.Compression 형식 어셈블리는 컴퓨터에서 사용할 수 있어야 합니다.
  • System.IO.Compression.FileSystem 형식 어셈블리는 컴퓨터에서 사용할 수 있어야 합니다.

키 속성

대상

확장된 콘텐츠를 쓰거나 제거해야 하는 폴더의 경로를 지정합니다.

Type: System.String

경로

보관 파일의 경로를 지정합니다.

Type: System.String

선택적 속성

체크섬

보관에 대해 확장된 콘텐츠의 유효성을 검사할 때 사용할 체크섬 메서드를 지정합니다. 체크섬의 값을 지정하고 유효성을 검사하는 $false경우 리소스가 잘못된 인수 예외를 throw합니다.

유효성 검사를 지정$true하는 경우 체크섬의 기본값은 .입니다ModifiedDate.

참고

체크섬 또는 유효성 검사 중 하나를 사용하는 것은 다른 항목을 의미합니다. 체크섬 없이 유효성 검사를 지정할 수 있지만 둘 다 함께 지정하는 것이 좋습니다.

지정된 메서드는 리소스가 아카이브에 대해 확장된 콘텐츠의 유효성을 검사하는 방법을 결정합니다.

  • 리소스 ModifiedDate는 확장된 각 파일의 LastWriteTime 속성이 보관 파일에 있는 해당 파일의 LastWriteTime 속성과 일치하는지 확인합니다.
  • 리소스 CreatedDate는 확장된 각 파일의 CreationTime 속성이 보관 파일에 있는 해당 파일의 CreationTime 속성과 일치하는지 확인합니다.
  • SHA-256SHA-512리소스는 SHA-1지정된 SHA 메서드를 사용하여 보관 파일에 있는 해당 파일의 해시에 대해 확장된 각 파일의 해시를 확인합니다.
Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

자격 증명

필요한 경우 지정된 경로 및 대상 에 액세스할 수 있는 권한이 있는 사용자 계정의 자격 증명을 지정합니다.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

보관 파일의 확장된 콘텐츠가 있는지 여부를 지정합니다. 보관 파일을 확장하려면 이 속성을 .로 Present지정합니다. 보관 파일의 확장된 콘텐츠를 제거하려면 이 속성을 로 Absent지정합니다. 기본값은 Present입니다.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Force

대상에서 기존 콘텐츠를 덮어쓸지 여부를 지정합니다. Force인 경우 $false대상의 항목을 덮어써야 하는 경우 리소스 오류가 발생합니다. 기본값은 $false입니다.

Type: System.Boolean
Default Value: false

유효성 검사

지정된 체크섬 메서드를 통해 확장된 콘텐츠를 확인할지 여부를 지정합니다. 기본값은 $false입니다.

유효성 검사가 있고 $true 대상의 파일이 보관 파일과 일치하지 않는 경우:

  • 확인이 Present 있고 Force인 $false경우 대상의 파일을 덮어쓸 수 없다는 메시지와 함께 리소스 오류가 발생합니다.
  • Ensure is Present 와 Force가$true면 리소스가 파일을 덮어씁니다.
  • 확인이 있는 Absent경우 리소스는 파일을 제거하지 않습니다.
Type: System.Boolean
Default Value: false

예제