Delen via


ExtractFiles@1 - Bestanden uitpakken v1-taak

Gebruik deze taak om verschillende archief- en compressiebestanden te extraheren, zoals .7z, .rar, .tar.gz en .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.
# 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.
# 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.
# 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.

Invoerwaarden

archiveFilePatterns - Archiefbestandspatronen
string. Vereist. Standaardwaarde: **/*.zip.

Hiermee geeft u de bestandspaden of patronen van de archiefbestanden te extraheren. Ondersteunt meerdere regels met minimatchpatronen. Meer informatie over de taak Bestanden uitpakken.

Hiermee geeft u de patronen op die overeenkomen met de archieven die u wilt extraheren. Patronen beginnen standaard in de hoofdmap van de opslagplaats (hetzelfde als als u hebt opgegeven $(Build.SourcesDirectory).
Hiermee geeft u de patroonfilters op, één per regel, die overeenkomen met de archieven die moeten worden geëxtraheerd. Bijvoorbeeld:

  • test.zip extraheert het test.zip-bestand in de hoofdmap.
  • test/*.zip extraheert alle .zip bestanden in de testmap.
  • **/*.tar extraheert alle .tar-bestanden in de hoofdmap en submappen.
  • **/bin/*.7z extraheert alle .7z-bestanden in een submap met de naam 'bin'.
    Het patroon wordt gebruikt om alleen archiefbestandspaden te vinden, geen mappaden, en geen archiefinhoud die moet worden geëxtraheerd. U moet dus patronen opgeven, zoals **/bin/** in plaats van **/bin.

archiveFilePatterns - Archiefbestandspatronen
string. Vereist. Standaardwaarde: *.zip.

Hiermee geeft u de bestandspaden of patronen van de archiefbestanden te extraheren. Ondersteunt meerdere regels met minimatchpatronen. Meer informatie over de taak Bestanden uitpakken.


destinationFolder - Doelmap
string. Vereist.

Hiermee geeft u de doelmap waarin archiefbestanden moeten worden geëxtraheerd. Gebruik variabelen als bestanden zich niet in de opslagplaats bevinden. Bijvoorbeeld: $(agent.builddirectory).


cleanDestinationFolder - Doelmap opschonen voordat u het uitpakken
boolean. Standaardwaarde: true.

Hiermee geeft u de optie op om de doelmap op te schonen voordat archiefinhoud wordt geëxtraheerd.


overwriteExistingFiles - Bestaande bestanden overschrijven
boolean. Standaardwaarde: false.

Hiermee geeft u de optie voor het overschrijven van bestaande bestanden in de doelmap als deze al bestaan. Als de optie is, wordt falsein het script gevraagd of u bestaande bestanden wilt overschrijven.


pathToSevenZipTool - Pad naar het hulpprogramma 7z
string.

Hiermee geeft u het aangepaste pad naar het hulpprogramma 7z. Bijvoorbeeld C:\7z\7z.exe in Windows en /usr/local/bin/7z op MacOS/Ubuntu. Als deze niet is opgegeven in Windows, wordt de standaardversie van 7zip gebruikt die bij een taak wordt geleverd.


Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om bestanden uit archieven te extraheren naar een doelmap met behulp van overeenkomstpatronen. Er wordt een reeks standaardarchiefindelingen ondersteund, waaronder .zip, .jar, .war, .ear, .tar, .7z en meer.

Zie de naslaginformatie over bestandskoppelingspatronen voor meer informatie over bestandskoppelingspatronen.

Voorbeelden

Alle .zip bestanden recursief uitpakken

In dit voorbeeld worden alle .zip bestanden recursief geëxtraheerd, inclusief zowel hoofdbestanden als bestanden uit submappen.

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

Alle .zip-bestanden uit de submap extraheren

In dit voorbeeld wordt en geëxtraheerd test/one.ziptest/two.zip, maar blijft staan test/nested/three.zip.

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

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
Instelbare variabelen Deze taak heeft machtigingen voor het instellen van de volgende variabelen: Het instellen van variabelen is uitgeschakeld
Agentversie 2.182.1 of hoger
Taakcategorie Hulpprogramma
Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie Alle ondersteunde agentversies.
Taakcategorie Hulpprogramma

Zie ook