ExtractFiles@1 – Extrahera filer v1-uppgift

Använd den här uppgiften för att extrahera en mängd olika arkiv- och komprimeringsfiler, till exempel .7z, .rar, .tar.gz och .zip.

Syntax

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Indata

archiveFilePatterns - Arkivfilmönster
string. Krävs. Standardvärde: **/*.zip.

Anger filsökvägarna eller mönstren för de arkivfiler som ska extraheras. Stöder flera rader med minimatchmönster. Läs mer om aktiviteten Extrahera filer.

Anger de mönster som ska matcha de arkiv som du vill extrahera. Som standard börjar mönster i rotmappen på lagringsplatsen (samma som om du hade angett $(Build.SourcesDirectory).
Anger de mönsterfilter, en per rad, som matchar arkiven som ska extraheras. Exempel:

• test.zip extraherar test.zip-filen i rotmappen.
• test/*.zip extraherar alla .zip filer i testmappen.
• **/*.tar extraherar alla .tar-filer i rotmappen och undermapparna.
• **/bin/*.7z extraherar alla .7z-filer i en undermapp med namnet "bin".
  Mönstret används för att endast matcha arkivfilsökvägar, inte mappsökvägar och inte arkivinnehåll som ska extraheras. Därför bör du ange mönster, till exempel **/bin/** i stället för **/bin.

destinationFolder - Målmappen
string. Krävs.

Anger målmappen som arkivfiler ska extraheras till. Använd variabler om filer inte finns på lagringsplatsen. Exempel: $(agent.builddirectory).

cleanDestinationFolder - Rensa målmappen innan du extraherar
boolean. Standardvärde: true.

Anger alternativet att rensa målkatalogen innan arkivinnehåll extraheras till den.

overwriteExistingFiles - Skriv över befintliga filer
boolean. Standardvärde: false.

Anger alternativet att skriva över befintliga filer i målkatalogen om de redan finns. Om alternativet är falsefrågar skriptet om befintliga filer och frågar om du vill skriva över dem.

pathToSevenZipTool - Sökväg till 7z-verktyget
string.

Anger den anpassade sökvägen till 7z-verktyget. Till exempel C:\7z\7z.exe i Windows och /usr/local/bin/7z i MacOS/Ubuntu. Om den inte anges i Windows används standardversionen av 7zip som medföljer en uppgift.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften för att extrahera filer från arkiv till en målmapp med hjälp av matchningsmönster. En rad standardarkivformat stöds, inklusive .zip, .jar, .war, .ear, .tar, .7z med mera.

Mer information om filmatchningsmönster finns i referensen filmatchningsmönster.

Exempel

Extrahera alla .zip filer rekursivt

I det här exemplet extraheras alla .zip filer rekursivt, inklusive både rotfiler och filer från undermappar.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Extrahera alla .zip filer från undermappen

Det här exemplet extraherar test/one.zip och test/two.zip, men lämnar test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här uppgiften körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler	Den här aktiviteten har behörighet att ange följande variabler: Inställningsvariabler är inaktiverade
Agentversion	2.182.1 eller senare
Uppgiftskategori	Verktyg

Se även

• Referens för filmatchningsmönster