Bagikan melalui


Compress-Archive

Membuat arsip terkompresi, atau file zip, dari file dan direktori tertentu.

Sintaks

Compress-Archive
        [-Path] <String[]>
        [-DestinationPath] <String>
        [-CompressionLevel <String>]
        [-PassThru]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Compress-Archive
        [-Path] <String[]>
        [-DestinationPath] <String>
        [-CompressionLevel <String>]
        -Update
        [-PassThru]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Compress-Archive
        [-Path] <String[]>
        [-DestinationPath] <String>
        [-CompressionLevel <String>]
        -Force
        [-PassThru]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Compress-Archive
        -LiteralPath <String[]>
        [-DestinationPath] <String>
        [-CompressionLevel <String>]
        -Update
        [-PassThru]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Compress-Archive
        -LiteralPath <String[]>
        [-DestinationPath] <String>
        [-CompressionLevel <String>]
        -Force
        [-PassThru]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Compress-Archive
        -LiteralPath <String[]>
        [-DestinationPath] <String>
        [-CompressionLevel <String>]
        [-PassThru]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Deskripsi

cmdlet Compress-Archive membuat file arsip yang dikompresi, atau di-zip dari satu atau beberapa file atau direktori yang ditentukan. Arsip mengemas beberapa file, dengan kompresi opsional, ke dalam satu file zip untuk distribusi dan penyimpanan yang lebih mudah. File arsip dapat dikompresi menggunakan algoritma kompresi yang ditentukan oleh parameter CompressionLevel.

Cmdlet Compress-Archive menggunakan API System.IO.Compression.ZipArchive untuk mengompresi file. API membatasi ukuran file maksimum hingga 2GB. Untuk informasi selengkapnya, lihat System.IO.Compression.ZipArchive.

Nota

cmdlet Compress-Archive mengabaikan file dan folder tersembunyi saat membuat atau memperbarui file arsip. Pada komputer non-Windows, ini termasuk file dan folder dengan nama yang dimulai dengan karakter titik (.).

Untuk memastikan file dan folder tersembunyi dikompresi ke dalam arsip, gunakan .NET API sebagai gantinya.

Beberapa contoh menggunakan splatting untuk mengurangi panjang baris sampel kode. Untuk informasi selengkapnya, lihat about_Splatting.

Contoh

Contoh 1: Memadatkan file untuk membuat file arsip

Contoh ini mengompresi file dari direktori yang berbeda dan membuat file arsip. Kartubebas digunakan untuk mendapatkan semua file dengan ekstensi file tertentu. Tidak ada struktur direktori dalam file arsip karena jalur hanya menentukan nama file.

$compress = @{
  Path = "C:\Reference\Draftdoc.docx", "C:\Reference\Images\*.vsd"
  CompressionLevel = "Fastest"
  DestinationPath = "C:\Archives\Draft.zip"
}
Compress-Archive @compress

Parameter Jalur menerima nama file dan nama file tertentu dengan wildcard, *.vsd. Jalur menggunakan daftar yang dipisahkan koma untuk mendapatkan file dari direktori yang berbeda. Tingkat kompresi Tercepat untuk mengurangi waktu pemrosesan. Parameter DestinationPath menentukan lokasi untuk file Draft.zip. File Draft.zip berisi Draftdoc.docx dan semua file dengan ekstensi .vsd.

Contoh 2: Memadatkan file menggunakan LiteralPath

Contoh ini memadatkan file bernama tertentu dan membuat file arsip baru. Tidak ada struktur direktori dalam file arsip karena jalur hanya menentukan nama file.

$compress = @{
LiteralPath= "C:\Reference\Draft Doc.docx", "C:\Reference\Images\diagram2.vsd"
CompressionLevel = "Fastest"
DestinationPath = "C:\Archives\Draft.zip"
}
Compress-Archive @compress

Jalur absolut dan nama file digunakan karena parameter LiteralPath tidak menerima kartubebas. Jalur menggunakan daftar yang dipisahkan koma untuk mendapatkan file dari direktori yang berbeda. Tingkat kompresi Tercepat untuk mengurangi waktu pemrosesan. Parameter DestinationPath menentukan lokasi untuk file Draft.zip. File Draft.zip hanya berisi Draftdoc.docx dan diagram2.vsd.

Contoh 3: Memadatkan direktori yang menyertakan direktori akar

Contoh ini mengompresi direktori dan membuat file arsip yang menyertakan direktori akar, dan semua file dan subdirektorinya. File arsip memiliki struktur direktori karena jalur menentukan direktori akar.

Compress-Archive -Path C:\Reference -DestinationPath C:\Archives\Draft.zip

Compress-Archive menggunakan parameter Jalur untuk menentukan direktori akar, C:\Reference. Parameter DestinationPath menentukan lokasi untuk file arsip. Arsip Draft.zip mencakup direktori akar Reference, dan semua file dan subdirektorinya.

Contoh 4: Memadatkan direktori yang mengecualikan direktori akar

Contoh ini mengompresi direktori dan membuat file arsip yang mengecualikan direktori akar karena jalur menggunakan kartubebas tanda bintang (*). Arsip berisi struktur direktori yang berisi file direktori akar dan subdirektori.

Compress-Archive -Path C:\Reference\* -DestinationPath C:\Archives\Draft.zip

Compress-Archive menggunakan parameter Jalur untuk menentukan direktori akar, C:\Reference dengan kartubebas tanda bintang (*). Parameter DestinationPath menentukan lokasi untuk file arsip. Arsip Draft.zip berisi file dan subdirektori direktori akar. Direktori akar Reference dikecualikan dari arsip.

Contoh 5: Memadatkan hanya file dalam direktori akar

Contoh ini hanya mengompresi file dalam direktori akar dan membuat file arsip. Tidak ada struktur direktori dalam arsip karena hanya file yang dikompresi.

Compress-Archive -Path C:\Reference\*.* -DestinationPath C:\Archives\Draft.zip

Compress-Archive menggunakan parameter Jalur untuk menentukan direktori akar, C:\Reference dengan wildcard bintang-titik bintang (*.*). Parameter DestinationPath menentukan lokasi untuk file arsip. Arsip Draft.zip hanya berisi file direktori akar Reference dan direktori akar dikecualikan.

Contoh 6: Gunakan alur untuk mengarsipkan file

Contoh ini mengirim file ke bawah alur untuk membuat arsip. Tidak ada struktur direktori dalam file arsip karena jalur hanya menentukan nama file.

Get-ChildItem -Path C:\Reference\Afile.txt, C:\Reference\Images\Bfile.txt |
  Compress-Archive -DestinationPath C:\Archives\PipelineFiles.zip

Get-ChildItem menggunakan parameter Jalur untuk menentukan dua file dari direktori yang berbeda. Setiap file diwakili oleh objek FileInfo dan dikirimkan alur ke Compress-Archive. Dua file yang ditentukan diarsipkan dalam PipelineFiles.zip.

Contoh 7: Gunakan alur untuk mengarsipkan direktori

Contoh ini mengirimkan direktori ke bawah alur untuk membuat arsip. File dikirim sebagai fileInfo objek dan direktori sebagai objek DirectoryInfo. Struktur direktori arsip tidak menyertakan direktori akar, tetapi file dan subdirektorinya disertakan dalam arsip.

Get-ChildItem -Path C:\LogFiles |
    Compress-Archive -DestinationPath C:\Archives\PipelineDir.zip

Get-ChildItem menggunakan parameter Jalur untuk menentukan direktori akar C:\LogFiles. Setiap FileInfo dan objek DirectoryInfo dikirimkan ke alur.

Compress-Archive menambahkan setiap objek ke arsip PipelineDir.zip. Parameter Jalur tidak ditentukan karena objek alur diterima ke dalam posisi parameter 0.

Contoh 8: Bagaimana rekursi dapat memengaruhi arsip

Contoh ini menunjukkan bagaimana rekursi dapat menduplikasi file di arsip Anda. Misalnya, jika Anda menggunakan Get-ChildItem dengan parameter Recurse. Sebagai proses rekursi, setiap FileInfo dan objek DirectoryInfo dikirim ke alur dan ditambahkan ke arsip.

Get-ChildItem -Path C:\TestLog -Recurse |
  Compress-Archive -DestinationPath C:\Archives\PipelineRecurse.zip

Direktori C:\TestLog tidak berisi file apa pun. Ini memang berisi subdirektori bernama testsub yang berisi file testlog.txt.

Get-ChildItem menggunakan parameter Jalur untuk menentukan direktori akar, C:\TestLog. Parameter Recurse memproses file dan direktori. Objek DirectoryInfo dibuat untuk testsub dan objek FileInfotestlog.txt.

Setiap objek dikirimkan alur ke Compress-Archive. DestinationPath menentukan lokasi untuk file arsip. Parameter Jalur tidak ditentukan karena objek alur diterima ke dalam posisi parameter 0.

Ringkasan berikut menjelaskan konten arsip PipelineRecurse.zip yang berisi file duplikat:

  • Objek DirectoryInfo membuat direktori testsub dan berisi file testlog.txt, yang mencerminkan struktur direktori asli.
  • Objek FileInfo membuat testlog.txt duplikat di akar arsip. File duplikat dibuat karena rekursi mengirim objek file ke Compress-Archive. Perilaku ini diharapkan karena setiap objek yang dikirim ke alur ditambahkan ke arsip.

Contoh 9: Memperbarui file arsip yang sudah ada

Contoh ini memperbarui file arsip yang ada, Draft.zip, di direktori C:\Archives. Dalam contoh ini, file arsip yang ada berisi direktori akar, serta file dan subdirektorinya.

Compress-Archive -Path C:\Reference -Update -DestinationPath C:\Archives\Draft.zip

Perintah memperbarui Draft.zip dengan versi file yang ada yang lebih baru di direktori C:\Reference dan subdirektorinya. Dan, file baru yang ditambahkan ke C:\Reference atau subdirektorinya disertakan dalam arsip Draft.zip yang diperbarui.

Parameter

-CompressionLevel

Menentukan berapa banyak kompresi yang akan diterapkan saat Anda membuat file arsip. Pemadatan yang lebih cepat membutuhkan lebih sedikit waktu untuk membuat file, tetapi dapat menghasilkan ukuran file yang lebih besar.

Jika parameter ini tidak ditentukan, perintah menggunakan nilai default, Optimal.

Berikut ini adalah nilai yang dapat diterima untuk parameter ini:

  • Tercepat . Gunakan metode kompresi tercepat yang tersedia untuk mengurangi waktu pemrosesan. Pemadatan yang lebih cepat dapat menghasilkan ukuran file yang lebih besar.
  • NoCompression . Tidak memadatkan file sumber.
  • Optimal . Waktu pemrosesan tergantung pada ukuran file.
Jenis:String
Nilai yang diterima:Optimal, NoCompression, Fastest
Position:Named
Nilai default:Optimal
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DestinationPath

Parameter ini diperlukan dan menentukan jalur ke file output arsip. DestinationPath harus menyertakan nama file zip, dan jalur absolut atau relatif ke file zip.

Jika nama file di DestinationPath tidak memiliki ekstensi nama file .zip, cmdlet menambahkan ekstensi nama file .zip.

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Force

Gunakan parameter ini untuk menimpa file arsip yang ada.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-LiteralPath

Menentukan jalur atau jalur ke file yang ingin Anda tambahkan ke file zip arsip. Tidak seperti parameter Jalur, nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan setiap karakter escape dalam tanda kutip tunggal, untuk menginstruksikan PowerShell untuk tidak menafsirkan karakter apa pun sebagai urutan escape. Untuk menentukan beberapa jalur, dan menyertakan file di beberapa lokasi dalam file zip output Anda, gunakan koma untuk memisahkan jalur.

Jenis:String[]
Alias:PSPath
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-PassThru

Menyebabkan cmdlet menghasilkan objek file yang mewakili file arsip yang dibuat.

Parameter ini diperkenalkan di PowerShell 6.0.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan jalur atau jalur ke file yang ingin Anda tambahkan ke file zip arsip. Untuk menentukan beberapa jalur, dan menyertakan file di beberapa lokasi, gunakan koma untuk memisahkan jalur.

Parameter ini menerima karakter kartubebas. Karakter kartubebas memungkinkan Anda menambahkan semua file dalam direktori ke file arsip Anda.

Menggunakan kartubebas dengan direktori akar memengaruhi konten arsip:

  • Untuk membuat arsip yang menyertakan direktori akar, dan semua file dan subdirektorinya, tentukan direktori akar di jalur tanpa wildcard. Misalnya: -Path C:\Reference
  • Untuk membuat arsip yang kecualikan direktori akar, tetapi zip semua file dan subdirektorinya, gunakan kartubebas tanda bintang (*). Misalnya: -Path C:\Reference\*
  • Untuk membuat arsip yang hanya meng-zip file di direktori akar, gunakan wildcard star-dot-star (*.*). Subdirektori akar tidak disertakan dalam arsip. Misalnya: -Path C:\Reference\*.*
Jenis:String[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:True

-Update

Memperbarui arsip yang ditentukan dengan mengganti versi file yang lebih lama dalam arsip dengan versi file yang lebih baru yang memiliki nama yang sama. Anda juga dapat menambahkan parameter ini untuk menambahkan file ke arsip yang ada.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

Anda dapat menyalurkan string yang berisi jalur ke satu atau beberapa file.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

FileInfo

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek FileInfo.

Catatan

Menggunakan rekursi dan mengirim objek ke bawah alur dapat menduplikasi file di arsip Anda. Misalnya, jika Anda menggunakan Get-ChildItem dengan parameter Recurse, setiap FileInfo dan objek DirectoryInfo yang dikirimkan alur ditambahkan ke arsip.

Cmdlet Compress-Archive menggunakan pengodean UTF-8. Alat arsip ZIP lainnya dapat menggunakan skema pengodean yang berbeda. Saat mengekstrak file dengan nama file yang tidak disimpan menggunakan pengodean UTF-8, Expand-Archive menggunakan nilai mentah yang ditemukan dalam arsip. Ini dapat mengakibatkan nama file yang berbeda dari nama file sumber yang disimpan dalam arsip.