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 以上
タスクのカテゴリ	ユーティリティ

こちらもご覧ください

• CopyFiles@2