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.
# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
inputs:
secureFile: # string. Required. Secure File.
#retryCount: '5' # string. Retry Count. Default: 5.
输入
secureFile
-
安全文件
string。 必填。
指定下载到代理计算机的安全文件的名称或唯一标识符（GUID）。 管道作业完成时会删除该文件。
retryCount
-
重试计数
string。 默认值：8。
可选。 指定在下载失败时重试下载安全文件的次数。
retryCount
-
重试计数
string。 默认值：5。
可选。 指定在下载失败时重试下载安全文件的次数。
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/