CopyFiles@1 - ファイルのコピー v1 タスク
このタスクを使用して、一致パターンを使用してソース フォルダーからターゲット フォルダーにファイルをコピーします。 (一致パターンは、フォルダー パスではなく、ファイル パスにのみ一致します)。
注意
このタスクの新しいバージョンは 、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で使用できます。
一致するファイルがない場合でも、タスクは成功を報告します。 一致するファイルがターゲット フォルダーに既に存在する場合は、 が true に設定されていない限り Overwrite 、タスクはエラーを報告します。
要件
| 要件 | 説明 |
|---|---|
| パイプラインの種類 | YAML、クラシック ビルド |
| 上で実行 | エージェント、DeploymentGroup |
| 確認要求 | なし |
| Capabilities | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
| コマンドの制限 | Any |
| 設定可能な変数 | Any |
| エージェントのバージョン | 1.91.0 以上 |
| タスクのカテゴリ | ユーティリティ |