Delen via

Expand-Archive

  • Referentie
Module:
Microsoft.PowerShell.Archive

Extraheert bestanden uit een opgegeven ZIP-archiefbestand.

Syntaxis

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

Description

De Expand-Archive cmdlet extraheert bestanden uit een opgegeven gezipt archiefbestand naar een opgegeven doelmap. Met een archiefbestand kunnen meerdere bestanden worden verpakt en eventueel gecomprimeerd in één gezipt bestand voor eenvoudigere distributie en opslag.

De Expand-Archive cmdlet maakt gebruik van de System.IO.Compression.ZipArchive-API om bestanden te comprimeren. De API beperkt de maximale bestandsgrootte tot 2 GB. De .NET-API werkt met bestanden die voldoen aan de officiële ZIP-bestandsindelingsspecificatie van PKWARE Inc. Zie System.IO.Compression.ZipArchive voor meer informatie.

Voorbeelden

Voorbeeld 1: De inhoud van een archief extraheren

In dit voorbeeld wordt de inhoud van een bestaand archiefbestand geëxtraheerd in de map die is opgegeven door de parameter DestinationPath .

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

In dit voorbeeld wordt de parameter LiteralPath gebruikt omdat de bestandsnaam tekens bevat die kunnen worden geïnterpreteerd als jokertekens.

Voorbeeld 2: De inhoud van een archief extraheren in de huidige map

In dit voorbeeld wordt de inhoud van een bestaand archiefbestand in de huidige map geëxtraheerd naar de map die is opgegeven door de parameter DestinationPath .

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

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DestinationPath

Maakt standaard Expand-Archive een map op de huidige locatie die dezelfde naam heeft als het ZIP-bestand. Met de parameter kunt u het pad naar een andere map opgeven. De doelmap wordt gemaakt als deze niet bestaat.

Type:String
Position:1
Default value:A folder in the current location
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Gebruik deze parameter om bestaande bestanden te overschrijven. Expand-Archive Overschrijft standaard niet.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u het pad naar een archiefbestand. In tegenstelling tot de parameter Path wordt de waarde van LiteralPath exact gebruikt zoals deze is getypt. Jokertekens worden niet ondersteund. Als het pad escapetekens bevat, plaatst u elk escapeteken tussen enkele aanhalingstekens om PowerShell te instrueren geen tekens te interpreteren als escapereeksen.

Type:String
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Zorgt ervoor dat de cmdlet een lijst uitvoert met de bestanden die zijn uitgevouwen uit het archief.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar het archiefbestand.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks doorsluisen die een pad naar een bestaand archiefbestand bevat.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

FileSystemInfo

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een lijst met bestanden die zijn uitgebreid uit het archief.

Notities

De Compress-Archive cmdlet maakt gebruik van UTF-8-codering. Andere ZIP-archiefprogramma's kunnen een ander coderingsschema gebruiken. Bij het extraheren van bestanden met bestandsnamen die niet zijn opgeslagen met UTF-8-codering, Expand-Archive wordt de onbewerkte waarde gebruikt die in het archief is gevonden. Dit kan resulteren in een andere bestandsnaam dan de bronbestandsnaam die is opgeslagen in het archief.