ExtractFiles@1 – Extrahera filer v1-uppgift

Använd den här uppgiften om du vill 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.

Ingångar

archiveFilePatterns - Arkivera filmönster
string. Obligatoriskt. 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 uppgiften 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. Till 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ålmapp
string. Obligatoriskt.

Anger målmappen till vilken arkivfiler ska extraheras. Använd variabler om filerna inte finns på lagringsplatsen. Till exempel: $(agent.builddirectory).

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

Anger alternativet att ta bort hela innehållet i målkatalogen (rensa) innan arkivinnehållet 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-verktyg
string.

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

Kontrollalternativ för aktivitet

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

Utdatavariabler

Ingen.

Anmärkningar

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
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här aktiviteten körs med hjälp av följande kommandobegränsningar: begränsad
variabler som kan	Den här uppgiften har behörighet att ange följande variabler: Inställningsvariabler är inaktiverade
Agentversion	2.182.1 eller senare
Aktivitetskategori	Nytta

Se även

• Referens för filmatchningsmönster