このタスクを使用して、一致パターンを使用してソース フォルダーからターゲット フォルダーにファイルをコピーします。 (一致パターンは、フォルダー パスではなく、ファイル パスにのみ一致します)。
注
このタスクの新しいバージョンは、CopyFiles@2で使用できます。
構文
# 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.
入力
ソース フォルダーの SourceFolder
-
string
。
任意 コピーするファイルを含むフォルダー。 フォルダーが空の場合、タスクは、$(Build.SourcesDirectory)
が指定されたかのように、リポジトリのルート フォルダーからファイルをコピーします。
ビルドでソース ディレクトリの外部で成果物が生成される場合は、パイプライン用に作成されたディレクトリからファイルをコピーする $(Agent.BuildDirectory)
を指定します。
Contents
-
コンテンツ
string
。 必須。 既定値: **
.
コピーの一部として含めるファイル パス。 この文字列は、複数行の一致パターンをサポートします。
次に例を示します。
-
*
指定したソース フォルダー内のすべてのファイルをコピーします。 -
**
は、指定したソース フォルダー内のすべてのファイルと、すべてのサブフォルダー内のすべてのファイルをコピーします。 -
**\bin\**
は、すべてのファイルを任意の bin フォルダーから再帰的にコピーします。
このパターンは、フォルダー パスではなく、ファイル パスのみを照合するために使用されます。
**\bin\**
ではなく、**\bin
などのパターンを指定します。
ビルド エージェントの種類に一致するパス区切り記号を使用します。 たとえば、linux エージェントには /
を使用する必要があります。 その他の例を次に示します。
ターゲット フォルダーの TargetFolder
-
string
。 必須。
コピーしたファイルを格納するターゲット フォルダーまたは UNC パス。
変数使用できます。 例: $(build.artifactstagingdirectory)
。
ターゲット フォルダーのクリーンを CleanTargetFolder
- する
boolean
。 既定値: false
.
任意 コピー 処理の前に、ターゲット フォルダー内のすべての既存のファイルを削除します。
OverWrite
-
上書き
boolean
。 既定値: false
.
任意 ターゲット フォルダー内の既存のファイルを置き換えます。
フォルダーをフラット化する flattenFolders
-
boolean
。 既定値: false
.
任意 フォルダー構造をフラット化し、すべてのファイルを指定したターゲット フォルダーにコピーします。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクの新しいバージョンは、CopyFiles@2で使用できます。
一致するファイルがない場合でも、タスクは成功を報告します。 一致したファイルがターゲット フォルダーに既に存在する場合、Overwrite
が true に設定されていない限り、タスクは失敗を報告します。
必要条件
要件 | 説明 |
---|---|
パイプラインの種類 | YAML、クラシック ビルド |
実行日 | エージェント、DeploymentGroup |
の需要 | なし |
機能の | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
コマンドの制限 | どれでも |
設定可能な変数 | どれでも |
エージェントのバージョン | 1.91.0 以上 |
タスク カテゴリ | 効用 |