CopyFiles@1 – Aufgabe "Dateien kopieren v1"
Verwenden Sie diese Aufgabe, um Dateien aus einem Quellordner mithilfe von Übereinstimmungsmustern in einen Zielordner zu kopieren. (Die Übereinstimmungsmuster entsprechen nur Dateipfaden, nicht Ordnerpfaden).
Hinweis
Es ist eine neuere Version dieser Aufgabe unter CopyFiles@2 verfügbar.
Syntax
# Copy Files v1
# Copy files from source folder to target folder using minimatch patterns (The minimatch patterns will only match file paths, not folder paths).
- task: CopyFiles@1
inputs:
#SourceFolder: # string. Source Folder.
Contents: '**' # string. Required. Contents. Default: **.
TargetFolder: # string. Required. Target Folder.
# Advanced
#CleanTargetFolder: false # boolean. Clean Target Folder. Default: false.
#OverWrite: false # boolean. Overwrite. Default: false.
#flattenFolders: false # boolean. Flatten Folders. Default: false.
Eingaben
SourceFolder
- Quellordner
string
.
Optional. Der Ordner, der die Dateien enthält, die Sie kopieren möchten. Wenn der Ordner leer ist, kopiert die Aufgabe Dateien aus dem Stammordner des Repositorys, als ob $(Build.SourcesDirectory)
angegeben wurde.
Wenn Ihr Build Artefakte außerhalb des Quellenverzeichnisses erzeugt, geben Sie $(Agent.BuildDirectory)
an, damit Dateien aus dem für die Pipeline erstellten Verzeichnis kopiert werden.
Contents
- Inhalt
string
. Erforderlich. Standardwert. **
.
Die Dateipfade, die als Teil der Kopie eingeschlossen werden sollen. Diese Zeichenfolge unterstützt mehrere Zeilen mit Übereinstimmungsmustern.
Beispiel:
*
kopiert alle Dateien im angegebenen Quellordner.**
kopiert alle Dateien im angegebenen Quellordner und alle Dateien in allen Unterordnern.**\bin\**
kopiert alle Dateien rekursiv aus einem beliebigen Bin-Ordner.
Das Muster wird nur verwendet, um Dateipfade abzugleichen, nicht für Ordnerpfade. Geben Sie Muster an, z **\bin\**
. B. anstelle von **\bin
.
Verwenden Sie das Pfadtrennzeichen, das Ihrem Build-Agent-Typ entspricht. /
Beispielsweise muss für Linux-Agents verwendet werden. Im Folgenden werden mehr Beispiele veranschaulicht.
TargetFolder
- Zielordner
string
. Erforderlich.
Der Zielordner oder UNC-Pfad, der die kopierten Dateien enthält. Sie können Variablen verwenden. Beispiel: $(build.artifactstagingdirectory)
.
CleanTargetFolder
- Bereinigen des Zielordners
boolean
. Standardwert. false
.
Optional. Löscht alle vorhandenen Dateien im Zielordner vor dem Kopiervorgang.
OverWrite
- Überschreiben
boolean
. Standardwert. false
.
Optional. Ersetzt die vorhandenen Dateien im Zielordner.
flattenFolders
- Ordner flachen
boolean
. Standardwert. false
.
Optional. Vereinfacht die Ordnerstruktur und kopiert alle Dateien in den angegebenen Zielordner.
Optionen für die Vorgangskontrolle
Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.
Ausgabevariablen
Keine.
Hinweise
Es ist eine neuere Version dieser Aufgabe unter CopyFiles@2 verfügbar.
Wenn keine Dateien übereinstimmen, meldet die Aufgabe weiterhin erfolglos. Wenn bereits eine übereinstimmende Datei im Zielordner vorhanden ist, meldet die Aufgabe einen Fehler, es sei denn Overwrite
, sie ist auf true festgelegt.
Anforderungen
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | YAML, Klassischer Build |
Wird ausgeführt auf | Agent, DeploymentGroup |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 1.91.0 oder höher |
Aufgabenkategorie | Hilfsprogramm |