ExtractFiles@1 - Datei v1-Aufgabe extrahieren

Verwenden Sie diese Aufgabe, um eine Vielzahl von Archiv- und Komprimierungsdateien wie .7z, .rar, .tar.gz und .zipzu 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.

Eingänge

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

Gibt die Dateipfade oder Muster der zu extrahierenden Archivdateien an. Unterstützt mehrere Linien von Miniübereinstimmungsmustern. Erfahren Sie mehr über die aufgabe Dateien extrahieren.

Gibt die Muster an, die den zu extrahierenden Archiven entsprechen sollen. Standardmäßig beginnen Muster im Stammordner des Repositorys (identisch mit der Angabe $(Build.SourcesDirectory)).
Gibt die Musterfilter pro Zeile an, die den zu extrahierenden Archiven entsprechen. 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 unterordner.
• **/bin/*.7z extrahiert alle .7z Dateien in einem beliebigen Unterordner namens "bin".

Das Muster wird verwendet, um nur Archivdateipfade, nicht Ordnerpfade und nicht mit zu extrahierenden Archivinhalten übereinzugleichen. Daher sollten Sie Muster angeben, z. B. **/bin/** anstelle von **/bin.

Um Dateien aus anderen Pfaden zu extrahieren (z. B. ein Pipelineartefakt), verwenden Sie die Kopieren-Aufgabe, um die Datei zu kopieren, die Sie in den Stammordner Ihres Repositorys extrahieren möchten: $(Build.SourcesDirectory). Um beispielsweise ein Pipelineartefakt zu kopieren, verschieben Sie die Datei aus $(Pipeline.Workspace) nach $(Build.SourcesDirectory), und extrahieren Sie sie dann aus dem Stammordner oder den Unterordnern.

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 - Ordner "Ziel bereinigen" vor dem Extrahieren von
boolean. Standardwert: true.

Gibt die Option an, den gesamten Inhalt des Zielverzeichnisses zu löschen (sauber), bevor Archivinhalte darin extrahiert werden.

overwriteExistingFiles - Vorhandene Dateien überschreiben
boolean. Standardwert: false.

Gibt die Option an, vorhandene Dateien im Zielverzeichnis zu überschreiben, sofern sie bereits vorhanden sind. Wenn die Option falseist, werden die Skriptaufforderungen für vorhandene Dateien gefragt, ob Sie sie überschreiben möchten.

pathToSevenZipTool - Pfad zu 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 ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

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 vieles mehr.

Weitere Informationen zu Dateiabgleichsmustern finden Sie unter Dateiabgleichsmuster.

Beispiele

Rekursives Extrahieren aller .zip Dateien

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 test/one.zip und test/two.zipextrahiert, aber test/nested/three.zipbleiben.

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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Das Festlegen von Variablen ist deaktiviert.
Agentversion	2.182.1 oder höher
Vorgangskategorie	Nützlichkeit

Siehe auch

• Referenz zu Dateiabgleichsmustern