Compartir a través de

Expand-Archive

  • Referencia
Módulo:
Microsoft.PowerShell.Archive

Extrae archivos de un archivo ZIP especificado.

Sintaxis

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

Description

El Expand-Archive cmdlet extrae archivos de un archivo comprimido especificado en una carpeta de destino especificada. Un archivo de archivo permite empaquetar varios archivos y, opcionalmente, comprimirlos en un único archivo comprimido para facilitar la distribución y el almacenamiento.

El Expand-Archive cmdlet usa la API System.IO.Compression.ZipArchive para comprimir archivos. La API limita el tamaño máximo de archivo a 2 GB. La API de .NET funciona con archivos que se ajustan a la especificación oficial del formato de archivo ZIP de PKWARE Inc. Para obtener más información, consulte System.IO.Compression.ZipArchive.

Ejemplos

Ejemplo 1: Extracción del contenido de un archivo

En este ejemplo se extrae el contenido de un archivo de archivo existente en la carpeta especificada por el parámetro DestinationPath .

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

En este ejemplo, se usa el parámetro LiteralPath porque el nombre de archivo contiene caracteres que se pueden interpretar como caracteres comodín.

Ejemplo 2: Extracción del contenido de un archivo en la carpeta actual

En este ejemplo se extrae el contenido de un archivo de archivo existente de la carpeta actual en la carpeta especificada por el parámetro DestinationPath .

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

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DestinationPath

De forma predeterminada, Expand-Archive crea una carpeta en la ubicación actual que es el mismo nombre que el archivo ZIP. El parámetro permite especificar la ruta de acceso a una carpeta diferente. La carpeta de destino se crea si no existe.

Tipo:String
Posición:1
Valor predeterminado:A folder in the current location
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Use este parámetro para sobrescribir los archivos existentes. De forma predeterminada, Expand-Archive no sobrescribe.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LiteralPath

Especifica la ruta de acceso a un archivo de archivo. A diferencia del parámetro Path , el valor de LiteralPath se usa exactamente como se escribe. No se admiten caracteres comodín. Si la ruta de acceso incluye caracteres de escape, incluya cada carácter de escape entre comillas simples para indicar a PowerShell que no interprete ningún carácter como secuencias de escape.

Tipo:String
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Hace que el cmdlet muestre una lista de los archivos expandidos desde el archivo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso al archivo de archivo.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contiene una ruta de acceso a un archivo de archivo existente.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

FileSystemInfo

Cuando se usa el parámetro PassThru , este cmdlet devuelve una lista de archivos expandidos desde el archivo.

Notas

El Compress-Archive cmdlet usa la codificación UTF-8. Otras herramientas de archivo ZIP pueden usar un esquema de codificación diferente. Al extraer archivos con nombres de archivo que no se almacenan mediante codificación UTF-8, Expand-Archive usa el valor sin procesar que se encuentra en el archivo. Esto puede dar lugar a un nombre de archivo diferente del nombre de archivo de origen almacenado en el archivo.