Expand-Archive

  • Riferimento
Modulo:
Microsoft.PowerShell.Archive

Estrae i file da un file di archivio (compresso) 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.

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.

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

Type:String
Position:1
Default value:A folder in the current location
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

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

-PassThru

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

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

-Path

Specifica il percorso del file di archivio.

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

-WhatIf

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

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