Condividi tramite

Expand-Archive

  • Riferimento
Modulo:
Microsoft.PowerShell.Archive

Estrae i file da un file di archivio ZIP specificato.

Sintassi

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

Descrizione

Il Expand-Archive cmdlet estrae i file da un file di archivio compresso specificato in una cartella di destinazione specificata. Un file di archivio consente la creazione di pacchetti di più file e, facoltativamente, in un singolo file compresso per semplificare la distribuzione e l'archiviazione.

Il Expand-Archive cmdlet usa l'API System.IO.Compression.ZipArchive per comprimere i file. L'API limita le dimensioni massime del file a 2 GB. L'API .NET funziona con i file conformi alla specifica ufficiale del formato di file ZIP di PKWARE Inc. Per altre informazioni, vedere System.IO.Compression.ZipArchive.

Esempio

Esempio 1: Estrarre il contenuto di un archivio

In questo esempio viene estratto il contenuto di un file di archivio esistente nella cartella specificata dal parametro DestinationPath .

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

In questo esempio viene utilizzato il parametro LiteralPath perché il nome file contiene caratteri che possono essere interpretati come caratteri jolly.

Esempio 2: Estrarre il contenuto di un archivio nella cartella corrente

In questo esempio viene estratto il contenuto di un file di archivio esistente nella cartella corrente nella cartella specificata dal parametro DestinationPath .

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

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationPath

Per impostazione predefinita, Expand-Archive crea una cartella nel percorso corrente con lo stesso nome del file ZIP. Il parametro consente di specificare il percorso di una cartella diversa. La cartella di destinazione viene creata se non esiste.

Tipo:String
Posizione:1
Valore predefinito:A folder in the current location
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Usare questo parametro per sovrascrivere i file esistenti. Per impostazione predefinita, Expand-Archive non sovrascrive.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LiteralPath

Specifica il percorso di un file di archivio. A differenza del parametro Path , il valore di LiteralPath viene usato esattamente come viene tipizzato. I caratteri jolly non sono supportati. Se il percorso include caratteri di escape, racchiudere ogni carattere di escape tra virgolette singole per indicare a PowerShell di non interpretare i caratteri come sequenze di escape.

Tipo:String
Alias:PSPath
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Fa sì che il cmdlet restituisca un elenco dei file espansi dall'archivio.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso del file di archivio.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente un percorso a un file di archivio esistente.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

FileSystemInfo

Quando si usa il parametro PassThru , questo cmdlet restituisce un elenco di file espansi dall'archivio.

Note

Il Compress-Archive cmdlet usa la codifica UTF-8. Altri strumenti di archivio ZIP possono usare uno schema di codifica diverso. Quando si estraggono file con nomi file non archiviati usando la codifica UTF-8, Expand-Archive usa il valore non elaborato trovato nell'archivio. Ciò può comportare un nome file diverso dal nome file di origine archiviato nell'archivio.