DownloadPipelineArtifact@1 - 下載管線成品 v1 工作

使用此工作可從此管線的舊階段，或從另一個管線下載管線成品。

此工作有較新版本。 如需詳細資訊，請參閱 DownloadPipelineArtifact@2。

使用此工作可從此管線的舊階段，或從另一個管線下載管線成品。

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- task: DownloadPipelineArtifact@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

buildType - 下載所產生的成品
string. 必要。 允許的值： current (目前的組建) ， specific (特定組建) 。 預設值：current。

下載目前管線執行或從特定管線執行所產生的成品。

project - 專案
string. 當 buildType == specific 時為必要。

指定要從中下載管線成品的項目名稱或 GUID。

pipeline - 建置管線
輸入別名： definition。 string. 當 buildType == specific 時為必要。

管線的定義標識碼。 在執行中的管線中， definitionId 可以在 System.DefinitionId 變數中找到 。 definitionId您也可以從 Azure DevOps 入口網站中管線概觀頁面上的 URL 擷取 。 在下列 URL 範例中 definitionId ，是 78： https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary。 若要從特定管線定義下載成品，請從該管線擷取 definitionId ，並將其指定為 pipeline 參數。

specificBuildWithTriggering - 適當時，請從觸發組建下載成品。
boolean. 選擇性。 使用時機 buildType == specific。 預設值：false。

如果已核取，工作會從觸發組建下載成品。 如果沒有從指定的管線觸發組建，工作會從下列選項中指定的組建下載成品。

buildVersionToDownload - 要下載的組建版本
string. 當 buildType == specific 時為必要。 允許的值： latest、 latestFromBranch (來自特定分支的最新版，以及指定的組建標籤) ， specific (特定版本) 。 預設值：latest。

指定要下載的組建版本。

branchName - 分支名稱
string. 當 buildType == specific && buildVersionToDownload == latestFromBranch 時為必要。 預設值：refs/heads/master。

指定分支/ref 名稱上的篩選。 例如：refs/heads/develop。

pipelineId - 建立
輸入別名： buildId。 string. 當 buildType == specific && buildVersionToDownload == specific 時為必要。

要從中下載成品的管線執行標識符。 在執行中的管線中， buildId 可以在 Build.BuildId 變數中找到 。 buildId您也可以從 Azure DevOps 入口網站中管線執行摘要頁面上的 URL 擷取 。 在下列 URL 範例中 buildId ，是 1088： https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results。 若要從特定管線執行下載成品，請從該執行中擷取 buildId ，並將其指定為 buildId 參數。

tags - 建置標籤
string. 選擇性。 使用時機 buildType == specific && buildVersionToDownload != specific。

工作用來傳回標記組建的逗號分隔標籤清單。 不會傳回未標記的組建。

artifactName - 成品名稱
string.

指定要下載的成品名稱。 如果此值保留空白，工作會下載與管線執行相關聯的所有成品。

itemPattern - 比對模式
string. 預設值：**。

限制下載檔的檔案比對模式。 此值可以是一或多個以新行分隔的檔案比對模式。 深入瞭解 檔案比對模式。

targetPath - 目的地目錄
輸入別名： downloadPath。 string. 必要。 預設值：$(System.ArtifactsDirectory)。

將下載成品之代理程式電腦上的路徑。

無。