Dela via

Expand-Archive

  • Referens
Modul:
Microsoft.PowerShell.Archive

Extraherar filer från en angiven ZIP-arkivfil.

Syntax

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

Description

Cmdleten Expand-Archive extraherar filer från en angiven zippad arkivfil till en angiven målmapp. Med en arkivfil kan flera filer paketeras och eventuellt komprimeras till en enda zippad fil för enklare distribution och lagring.

Cmdleten Expand-Archive använder API:et System.IO.Compression.ZipArchive för att komprimera filer. API:et begränsar den maximala filstorleken till 2 GB. .NET-API:et fungerar med filer som överensstämmer med den officiella ZIP-filformatspecifikationen från PKWARE Inc. Mer information finns i System.IO.Compression.ZipArchive.

Exempel

Exempel 1: Extrahera innehållet i ett arkiv

I det här exemplet extraheras innehållet i en befintlig arkivfil till den mapp som anges av parametern DestinationPath .

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

I det här exemplet används parametern LiteralPath eftersom filnamnet innehåller tecken som kan tolkas som jokertecken.

Exempel 2: Extrahera innehållet i ett arkiv i den aktuella mappen

I det här exemplet extraheras innehållet i en befintlig arkivfil i den aktuella mappen till mappen som anges av parametern DestinationPath .

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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestinationPath

Som standard Expand-Archive skapar du en mapp på den aktuella platsen som är samma namn som ZIP-filen. Med parametern kan du ange sökvägen till en annan mapp. Målmappen skapas om den inte finns.

Typ:String
Position:1
Standardvärde:A folder in the current location
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Använd den här parametern för att skriva över befintliga filer. Skriv inte över som standard Expand-Archive .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LiteralPath

Anger sökvägen till en arkivfil. Till skillnad från parametern Path används värdet för LiteralPath precis som det skrivs. Jokertecken stöds inte. Om sökvägen innehåller escape-tecken omger du varje escape-tecken inom enkla citattecken för att instruera PowerShell att inte tolka några tecken som escape-sekvenser.

Typ:String
Alias:PSPath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Gör att cmdleten matar ut en lista över de filer som expanderats från arkivet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till arkivfilen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som innehåller en sökväg till en befintlig arkivfil.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

FileSystemInfo

När du använder parametern PassThru returnerar den här cmdleten en lista över filer som har expanderats från arkivet.

Kommentarer

Cmdleten Compress-Archive använder UTF-8-kodning. Andra ZIP-arkivverktyg kan använda ett annat kodningsschema. När du extraherar filer med filnamn som inte lagras med UTF-8-kodning använder Expand-Archive du det råvärde som finns i arkivet. Detta kan resultera i ett filnamn som skiljer sig från källfilnamnet som lagras i arkivet.