Partager via

Expand-Archive

  • Référence
Module:
Microsoft.PowerShell.Archive

Extrait les fichiers d’un fichier d’archive ZIP spécifié.

Syntaxe

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

Description

L’applet Expand-Archive de commande extrait les fichiers d’un fichier d’archive compressé spécifié dans un dossier de destination spécifié. Un fichier d’archivage permet à plusieurs fichiers d’être empaquetés, et éventuellement compressés, dans un fichier compressé unique pour faciliter la distribution et le stockage.

L’applet Expand-Archive de commande utilise l’API System.IO.Compression.ZipArchive pour compresser les fichiers. L’API limite la taille maximale du fichier à 2 Go. L’API .NET fonctionne avec des fichiers conformes à la spécification officielle du format de fichier ZIP par PKWARE Inc. Pour plus d’informations, consultez System.IO.Compression.ZipArchive.

Exemples

Exemple 1 : Extraire le contenu d’une archive

Cet exemple extrait le contenu d’un fichier d’archive existant dans le dossier spécifié par le paramètre DestinationPath .

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

Dans cet exemple, le paramètre LiteralPath est utilisé, car le nom de fichier contient des caractères qui peuvent être interprétés comme des caractères génériques.

Exemple 2 : Extraire le contenu d’une archive dans le dossier actif

Cet exemple extrait le contenu d’un fichier d’archive existant dans le dossier actif dans le dossier spécifié par le paramètre DestinationPath .

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

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationPath

Par défaut, Expand-Archive crée un dossier à l’emplacement actuel qui est le même nom que le fichier ZIP. Le paramètre vous permet de spécifier le chemin d’accès à un autre dossier. Le dossier cible est créé s’il n’existe pas.

Type:String
Position:1
Valeur par défaut:A folder in the current location
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Utilisez ce paramètre pour remplacer les fichiers existants. Par défaut, Expand-Archive ne remplace pas.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LiteralPath

Spécifie le chemin d’accès à un fichier d’archivage. Contrairement au paramètre Path , la valeur de LiteralPath est utilisée exactement comme elle est typée. Les caractères génériques ne sont pas pris en charge. Si le chemin inclut des caractères d’échappement, placez chaque caractère d’échappement entre guillemets simples pour indiquer à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String
Alias:PSPath
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Provoque la sortie de l’applet de commande d’une liste des fichiers développés à partir de l’archive.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès au fichier d’archivage.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de la commande cmdlet. La commande cmdlet n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin d’accès à un fichier d’archivage existant.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

FileSystemInfo

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne une liste de fichiers qui ont été développés à partir de l’archive.

Notes

L’applet de commande utilise l’encodage Compress-Archive UTF-8. D’autres outils d’archivage ZIP peuvent utiliser un autre schéma d’encodage. Lors de l’extraction de fichiers avec des noms de fichiers non stockés à l’aide de l’encodage UTF-8, Expand-Archive utilise la valeur brute trouvée dans l’archive. Cela peut entraîner un nom de fichier différent du nom de fichier source stocké dans l’archive.