Megosztás a következőn keresztül:

Expand-Archive

  • Referencia
Modul:
Microsoft.PowerShell.Archive

Kinyeri a fájlokat egy megadott ZIP-archívumfájlból.

Syntax

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

Description

A Expand-Archive parancsmag kibontja a fájlokat egy megadott tömörített archív fájlból egy megadott célmappába. Az archív fájlok lehetővé teszik több fájl egyetlen tömörített fájlba való csomagolását és szükség szerint tömörítését a könnyebb terjesztés és tárolás érdekében.

A Expand-Archive parancsmag a System.IO.Compression.ZipArchive API használatával tömöríti a fájlokat. Az API a maximális fájlméretet 2 GB-ra korlátozza. A .NET API olyan fájlokkal működik, amelyek megfelelnek a PKWARE Inc. hivatalos ZIP-fájlformátum-specifikációjának. További információ: System.IO.Compression.ZipArchive.

Példák

1. példa: Archívum tartalmának kinyerése

Ez a példa kinyeri egy meglévő archív fájl tartalmát a DestinationPath paraméter által megadott mappába.

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

Ebben a példában a LiteralPath paramétert használja a rendszer, mert a fájlnév olyan karaktereket tartalmaz, amelyek helyettesítő karakterekként értelmezhetők.

2. példa: Archívum tartalmának kinyerése az aktuális mappában

Ez a példa kinyeri az aktuális mappában lévő meglévő archív fájl tartalmát a DestinationPath paraméter által megadott mappába.

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

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DestinationPath

Alapértelmezés szerint Expand-Archive létrehoz egy mappát az aktuális helyen, amely megegyezik a ZIP-fájl nevével. A paraméterrel megadhatja egy másik mappa elérési útját. A célmappa akkor jön létre, ha nem létezik.

Típus:String
Position:1
Alapértelmezett érték:A folder in the current location
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Force

Ezzel a paraméter használatával felülírhatja a meglévő fájlokat. Alapértelmezés szerint Expand-Archive nem írja felül.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-LiteralPath

Egy archív fájl elérési útját adja meg. Az Elérési út paramétertől eltérően a LiteralPath értéke pontosan a beírt módon lesz használva. A helyettesítő karakterek nem támogatottak. Ha az elérési út menekülési karaktereket tartalmaz, az egyes feloldó karaktereket idézőjelek közé kell foglalni, hogy a PowerShell ne értelmezze a karaktereket menekülési sorozatként.

Típus:String
Aliasok:PSPath
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-PassThru

A parancsmag az archívumból kibontott fájlok listáját adja ki.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Path

Megadja az archív fájl elérési útját.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

Egy meglévő archív fájl elérési útját tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

FileSystemInfo

A PassThru paraméter használatakor ez a parancsmag visszaadja az archívumból kibontott fájlok listáját.

Jegyzetek

A Compress-Archive parancsmag UTF-8 kódolást használ. Más ZIP archív eszközök eltérő kódolási sémát használhatnak. Az UTF-8 kódolással Expand-Archive nem tárolt fájlnevekkel rendelkező fájlok kinyerésekor az archívumban található nyers értéket használja. Ez olyan fájlnevet eredményezhet, amely eltér az archívumban tárolt forrásfájlnévétől.