ExtractFiles@1 - ファイル v1 タスクを抽出する

このタスクを使用して、.7z、.rar、.tar.gz、.zipなど、さまざまなアーカイブ ファイルと圧縮ファイルを抽出します。

構文

# 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.

入力

archiveFilePatterns - アーカイブ ファイル パターン
string. 必須です。 既定値: **/*.zip。

抽出するアーカイブ ファイルのファイル パスまたはパターンを指定します。 複数行のミニマッチ パターンをサポートします。 詳細については、「 ファイルの抽出」タスクを参照してください。

抽出するアーカイブに一致するパターンを指定します。 既定では、パターンはリポジトリのルート フォルダーから開始されます (指定した $(Build.SourcesDirectory)場合と同じです)。
抽出するアーカイブに一致するパターン フィルターを 1 行に 1 つずつ指定します。 次に例を示します。

• test.zip ルート フォルダー内のtest.zip ファイルを抽出します。
• test/*.zip は、テスト フォルダー内のすべての.zip ファイルを抽出します。
• **/*.tar は、ルート フォルダーとサブフォルダー内のすべての .tar ファイルを抽出します。
• **/bin/*.7z は、"bin" という名前のサブフォルダー内のすべての .7z ファイルを抽出します。
  パターンは、フォルダー パスではなくアーカイブ ファイル パスのみを照合するために使用され、抽出されるアーカイブ コンテンツは一致しません。 そのため、 ではなく などの**/bin/****/binパターンを指定する必要があります。

destinationFolder - コピー先フォルダー
string. 必須です。

アーカイブ ファイルの抽出先フォルダーを指定します。 ファイルがリポジトリにない場合は 、変数 を使用します。 (例: $(agent.builddirectory))。

cleanDestinationFolder - 展開前にコピー先フォルダーをクリーンアップする
boolean. 既定値: true。

アーカイブの内容を抽出する前に、コピー先ディレクトリをクリーンアップするオプションを指定します。

overwriteExistingFiles - 既存のファイルを上書きする
boolean. 既定値: false。

宛先ディレクトリ内の既存のファイルが既に存在する場合に上書きするオプションを指定します。 オプションが の場合、 falseスクリプトは既存のファイルを上書きするかどうかを確認するプロンプトを表示します。

pathToSevenZipTool - 7z ユーティリティへのパス
string.

7z ユーティリティへのカスタム パスを指定します。 たとえば、 C:\7z\7z.exe Windows や /usr/local/bin/7z MacOS/Ubuntu などです。 Windows で指定されていない場合は、タスクに付属する既定の 7zip バージョンが使用されます。

タスク コントロール のオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、一致パターンを使用してアーカイブからターゲット フォルダーにファイルを抽出します。 .zip、.jar、.war、.ear、.tar、.7z など、さまざまな標準アーカイブ形式がサポートされています。

ファイルマッチングパターンの詳細については、「 ファイルマッチングパターンリファレンス」を参照してください。

例

すべての.zipファイルを再帰的に抽出する

この例では、ルート ファイルとサブフォルダーからのファイルの両方を含め、すべての.zip ファイルを再帰的に抽出します。

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

サブフォルダーからすべての.zip ファイルを抽出する

この例では、 と test/two.zipを抽出test/one.zipしますが、 はそのままにしますtest/nested/three.zip。

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

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	このタスクは、次の コマンド制限を使用して実行されます。
設定可能な変数	このタスクには、 次の変数を設定するアクセス許可があります。変数の設定は無効です
エージェントのバージョン	2.182.1 以上
タスクのカテゴリ	ユーティリティ

こちらもご覧ください

• ファイルマッチングパターンリファレンス