다음을 통해 공유

Expand-Archive

  • 참조
모듈:
Microsoft.PowerShell.Archive

지정된 ZIP 보관 파일에서 파일을 추출합니다.

구문

Expand-Archive
      [-Path] <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Expand-Archive
      -LiteralPath <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Expand-Archive 지정된 압축된 보관 파일에서 지정된 대상 폴더로 파일을 추출합니다. 보관 파일을 사용하면 여러 파일을 패키지하고 선택적으로 압축하여 더 쉽게 배포하고 스토리지할 수 있도록 단일 압축 파일로 압축할 수 있습니다.

이 cmdlet은 Expand-Archive System.IO.Compression.ZipArchive API를 사용하여 파일을 압축합니다. API는 최대 파일 크기를 2GB로 제한합니다. .NET API는 PKWARE Inc.의 공식 ZIP 파일 형식 사양을 준수하는 파일에서 작동합니다. 자세한 내용은 System.IO.Compression.ZipArchive를 참조 하세요.

예제

예제 1: 보관 파일의 내용 추출

다음은 대상 경로 매개 변수로 지정된 폴더에 기존 보관 파일의 내용을 추출하는 예제입니다.

Expand-Archive -LiteralPath 'C:\Archives\Draft[v1].zip' -DestinationPath C:\Reference

이 예제에서는 파일 이름에 와일드카드로 해석될 수 있는 문자가 포함되어 있으므로 LiteralPath 매개 변수가 사용됩니다.

예제 2: 현재 폴더에서 보관 파일의 내용 추출

다음은 현재 폴더에 있는 기존 보관 파일의 내용을 DestinationPath 매개 변수로 지정된 폴더로 추출하는 예제입니다.

Expand-Archive -Path Draftv2.zip -DestinationPath C:\Reference

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DestinationPath

기본적으로 Expand-Archive 현재 위치에 ZIP 파일과 이름이 같은 폴더를 만듭니다. 매개 변수를 사용하면 다른 폴더의 경로를 지정할 수 있습니다. 대상 폴더가 없으면 만들어집니다.

형식:String
Position:1
Default value:A folder in the current location
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

기존 파일을 덮어쓰려면 이 매개 변수를 사용합니다. 기본적으로 Expand-Archive 덮어쓰지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LiteralPath

보관 파일의 경로를 지정합니다. Path 매개 변수와 달리 LiteralPath 값은 입력된 대로 정확하게 사용됩니다. 와일드카드 문자는 지원되지 않습니다. 경로에 이스케이프 문자가 포함된 경우 각 이스케이프 문자를 작은따옴표로 묶어 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

형식:String
별칭:PSPath
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PassThru

cmdlet이 보관 파일에서 확장된 파일 목록을 출력하도록 합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Path

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

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet은 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

기존 보관 파일에 대한 경로가 포함된 문자열을 파이프할 수 있습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

FileSystemInfo

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 보관 파일에서 확장된 파일 목록을 반환합니다.

참고

cmdlet은 Compress-Archive UTF-8 인코딩을 사용합니다. 다른 ZIP 보관 도구는 다른 인코딩 체계를 사용할 수 있습니다. UTF-8 인코딩을 사용하여 저장되지 않은 파일 이름으로 파일을 추출하는 Expand-Archive 경우 보관 파일에 있는 원시 값을 사용합니다. 이렇게 하면 보관 파일에 저장된 원본 파일 이름과 다른 파일 이름이 발생할 수 있습니다.