Expand-Archive

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

Extrait les fichiers d’un fichier d’archive (compressé) spécifié.

Syntax

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.

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 génériques carte s.

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 l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:A folder in the current location
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

-Path

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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