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
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用以下命令 限制运行：受限
可设置变量	此任务有权 设置以下变量：secureFilePath
代理版本	2.182.1 或更高版本
任务类别	实用工具