DownloadSecureFile@1 - 下載安全檔案 v1 工作

使用此工作將安全檔案下載到代理程序計算機。

語法

# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File. 
    #retryCount: '8' # string. Retry Count. Default: 8.
    #socketTimeout: # string. Socket Timeout.

輸入

secureFile - 安全檔案
string。 必須的。

指定下載至代理程式電腦之安全檔案的名稱或唯一標識元（GUID）。 管線作業完成時，會刪除檔案。

retryCount - 重試計數
string。 預設值：8。

選擇性。 指定下載失敗時重試下載安全檔案的次數。

socketTimeout - 套接字逾時
string。

選擇性。 在 Microsoft 下載安全檔案要求時，此輸入會指定套接字的逾時。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

此工作會定義下列 輸出變數，您可以在下游步驟、作業和階段中取用這些變數。

secureFilePath
指定下載的安全檔案位置。

備註

在管線中使用這項工作，將 安全檔案 下載到代理程序計算機。 指定檔名時（使用 secureFile 輸入），請使用您在上傳檔案時指定的名稱，而不是實際的檔名。

備註

不論工作位於其作業中的位置為何，此工作都會在其階段的開頭執行。

下載之後，請使用在工作上設定的 name 值（或傳統編輯器中的「參考名稱」），參考代理程式計算機上安全檔案的路徑。 例如，如果工作指定名稱 mySecureFile，則其路徑可以在管線中參考為 $(mySecureFile.secureFilePath)。 或者，下載的安全檔案可以在 $(Agent.TempDirectory)提供的目錄中找到。 請參閱下列 的完整範例。

當管線作業完成時，不論它成功、失敗或取消，安全檔案會從其下載位置刪除。

安裝 Apple 憑證 或 安裝 Apple 布建配置檔 工作不需要使用此工作，因為它們會自動下載、安裝及刪除安全檔案（在管線作業結束時）。

此工作目前僅支援每個實例一個檔案工作。

範例

此範例會下載安全的憑證檔案，並將其安裝到 Linux 上的受信任證書頒發機構單位 （CA） 目錄：

- task: DownloadSecureFile@1
  name: caCertificate
  displayName: 'Download CA certificate'
  inputs:
    secureFile: 'myCACertificate.pem'

- script: |
    echo Installing $(caCertificate.secureFilePath) to the trusted CA directory...
    sudo chown root:root $(caCertificate.secureFilePath)
    sudo chmod a+r $(caCertificate.secureFilePath)
    sudo ln -s $(caCertificate.secureFilePath) /etc/ssl/certs/ 

需求

要求	說明
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	此工作會使用下列 命令限制執行： 受限制
Settable 變數	此工作具有 設定下列變數的許可權：secureFilePath
代理程式版本	2.182.1 或更新
工作類別	效用