ExtractFiles@1 : Datei extrahieren v1 Task

Verwenden Sie diese Aufgabe, um eine Vielzahl von Archiv- und Komprimierungsdateien wie .7z, .rar, .tar.gz und .zip zu extrahieren.

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.

Eingaben

archiveFilePatterns - Archivdateimuster
string. Erforderlich. Standardwert. **/*.zip.

Gibt die Dateipfade oder Muster der zu extrahierenden Archivdateien an. Unterstützt mehrere Zeilen mit Minimatchmustern. Erfahren Sie mehr über die Aufgabe Dateien extrahieren.

Gibt die Muster an, die mit den Archiven übereinstimmen, die Sie extrahieren möchten. Muster beginnen standardmäßig im Stammordner des Repositorys (identisch mit der Angabe $(Build.SourcesDirectory)von .
Gibt die Musterfilter pro Zeile an, die mit den zu extrahierenden Archiven übereinstimmen. Beispiel:

• test.zip extrahiert die test.zip-Datei im Stammordner.
• test/*.zip extrahiert alle .zip Dateien im Testordner.
• **/*.tar extrahiert alle TAR-Dateien im Stammordner und unterordnern.
• **/bin/*.7z extrahiert alle .7z-Dateien in jedem Unterordner mit dem Namen "bin".
  Das Muster wird verwendet, um nur Dateipfade zu archivieren, nicht Ordnerpfade und nicht Archivinhalte, die extrahiert werden sollen. Daher sollten Sie Muster angeben, z. B **/bin/** . anstelle von **/bin.

destinationFolder - Zielordner
string. Erforderlich.

Gibt den Zielordner an, in den Archivdateien extrahiert werden sollen. Verwenden Sie Variablen , wenn sich Dateien nicht im Repository befinden. Beispiel: $(agent.builddirectory).

cleanDestinationFolder - Bereinigen des Zielordners vor dem Extrahieren
boolean. Standardwert. true.

Gibt die Option an, das Zielverzeichnis zu bereinigen, bevor Archivinhalte extrahiert werden.

overwriteExistingFiles - Überschreiben vorhandener Dateien
boolean. Standardwert. false.

Gibt die Option an, vorhandene Dateien im Zielverzeichnis zu überschreiben, sofern sie bereits vorhanden sind. Wenn die Option lautet false, fragt das Skript zu vorhandenen Dateien, ob Sie sie überschreiben möchten.

pathToSevenZipTool - Pfad zum 7z-Hilfsprogramm
string.

Gibt den benutzerdefinierten Pfad zum 7z-Hilfsprogramm an. Beispielsweise C:\7z\7z.exe unter Windows und /usr/local/bin/7z unter MacOS/Ubuntu. Wenn sie unter Windows nicht angegeben ist, wird die standardmäßige 7zip-Version verwendet, die mit einer Aufgabe bereitgestellt wird.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu den Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um Dateien aus Archiven mithilfe von Übereinstimmungsmustern in einen Zielordner zu extrahieren. Eine Reihe von Standardarchivformaten wird unterstützt, einschließlich .zip, JAR, .war, .ear, .tar, .7z und mehr.

Weitere Informationen zu Dateiabgleichsmustern finden Sie in der Referenz zu Dateiübereinstimmungsmustern.

Beispiele

Extrahieren sie alle .zip Dateien rekursiv

In diesem Beispiel werden alle .zip Dateien rekursiv extrahiert, einschließlich Stammdateien und Dateien aus Unterordnern.

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

Extrahieren aller .zip Dateien aus dem Unterordner

In diesem Beispiel werden und test/two.zipextrahierttest/one.zip, aber belassentest/nested/three.zip.

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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Dieser Task wird mit den folgenden Befehlseinschränkungen ausgeführt: restricted
Einstellbare Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Festlegen von Variablen ist deaktiviert.
Agent-Version	2.182.1 oder höher
Aufgabenkategorie	Hilfsprogramm

Weitere Informationen

• Referenz zu Dateiabgleichsmustern