Share via

Compress-Archive

  • Referensi
Modul:
Microsoft.PowerShell.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

Compress-Archive Cmdlet 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 .

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

Catatan

Compress-Archive Cmdlet 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 kartubebas, *.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 .vsd ekstensi.

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-Archivemenggunakan parameter Jalur untuk menentukan direktori akar, C:\Reference. Parameter DestinationPath menentukan lokasi untuk file arsip. Arsip Draft.zip mencakup Reference direktori akar, 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-Archivemenggunakan 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 Reference akar 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-Archivemenggunakan parameter Jalur untuk menentukan direktori akar, C:\Reference dengan wildcard star-dot-star (*.*). Parameter DestinationPath menentukan lokasi untuk file arsip. Arsip Draft.zip hanya berisi Reference file direktori akar 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-ChildItemmenggunakan 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 objek dan direktori FileInfo 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-ChildItemmenggunakan parameter Jalur untuk menentukan C:\LogFiles direktori akar. Setiap objek FileInfo dan DirectoryInfo dikirim ke alur.

Compress-Archive menambahkan setiap objek ke PipelineDir.zip arsip. 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 objek FileInfo dan DirectoryInfo dikirimkan alur dan ditambahkan ke arsip.

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

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

Get-ChildItemmenggunakan parameter Jalur untuk menentukan direktori akar, C:\TestLog. Parameter Recurse memproses file dan direktori. Objek DirectoryInfo dibuat untuk testsub dan objek testlog.txtFileInfo .

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 PipelineRecurse.zip konten arsip yang berisi file duplikat:

  • Objek DirectoryInfo membuat testsub direktori dan berisi testlog.txt file, yang mencerminkan struktur direktori asli.
  • Objek FileInfo membuat duplikat testlog.txt 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 C:\Archives direktori. 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 diperbarui Draft.zip dengan versi file yang lebih baru dari file yang C:\Reference ada di direktori dan subdirektorinya. Dan, file baru yang ditambahkan ke C:\Reference atau subdirektorinya disertakan dalam arsip yang diperbarui Draft.zip .

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.
Type:String
Accepted values:Optimal, NoCompression, Fastest
Position:Named
Default value:Optimal
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .zip ekstensi nama file, cmdlet menambahkan .zip ekstensi nama file.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Gunakan parameter ini untuk menimpa file arsip yang ada.

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters: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 ditik. 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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Parameter ini diperkenalkan di PowerShell 6.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 mengecualikan direktori akar, tetapi zip semua file dan subdirektorinya, gunakan wildcard 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\*.*
Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 objek FileInfo dan DirectoryInfo yang dikirimkan alur ditambahkan ke arsip.

Compress-Archive Cmdlet 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.