AzureFileCopy@1 - Azure 文件复制 v1 任务

将文件复制到Azure Blob 存储或虚拟机。

注意

此任务不支持使用工作流联合身份验证进行 Azure 资源管理器身份验证。

语法

# Azure file copy v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArguments: # string. Additional Arguments. 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

输入

SourcePath - 源
string. 必需。

指定源文件夹、本地计算机上的文件或 UNC 共享的绝对路径。 指定的值或表达式应返回单个文件夹名称或文件名。

azureConnectionType - Azure 连接类型
输入别名： ConnectedServiceNameSelector。 string. 允许的值： ConnectedServiceName (Azure 经典) ， ConnectedServiceNameARM (Azure 资源管理器) 。 默认值：ConnectedServiceNameARM。

指定 Azure 连接类型。

azureClassicSubscription - Azure 经典订阅
输入别名： ConnectedServiceName。 string. 当 ConnectedServiceNameSelector = ConnectedServiceName 时，需要此选项。

指定目标 Azure 经典订阅。

azureSubscription - Azure 订阅
输入别名： ConnectedServiceNameARM。 string. 当 ConnectedServiceNameSelector = ConnectedServiceNameARM 时，需要此选项。

指定目标 Azure 资源管理器订阅。

Destination - 目标类型
string. 必需。 允许的值： AzureBlob (Azure Blob) ， AzureVMs (Azure VM) 。

指定要用于复制文件的目标类型。

classicStorage - 经典存储帐户
输入别名： StorageAccount。 string. 当 ConnectedServiceNameSelector = ConnectedServiceName 时，需要此选项。

指定预先存在的经典存储帐户。 这是用作将文件复制到 Azure VM 的中介的存储帐户。

storage - RM 存储帐户
输入别名： StorageAccountRM。 string. 当 ConnectedServiceNameSelector = ConnectedServiceNameARM 时，需要此选项。

指定预先存在的 ARM 存储帐户。 这是用作将文件复制到 Azure VM 的中介的存储帐户。

ContainerName - 容器名称
string. 当 Destination = AzureBlob 时，需要此选项。

指定文件复制到的容器的名称。 如果存储帐户中不存在指定的容器，则会创建该容器。

若要在容器中创建虚拟目录，请使用 Blob 前缀输入。

示例：对于目标位置 https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/，指定容器名称和 mycontainer Blob 前缀： vd1/vd2。

BlobPrefix - Blob 前缀
string. 可选。 在 时 Destination = AzureBlob使用 。

指定可用于筛选文件的前缀。

示例：可以追加一个内部版本号，以筛选具有相同内部版本号的所有 Blob 中的文件。

示例：如果指定 Blob 前缀 myvd1，则会在容器中创建虚拟目录。 文件从源 https://myaccount.blob.core.windows.net/mycontainer/myvd1/复制到 。

cloudService - 云服务
输入别名： EnvironmentName。 string. 当 ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs 时，需要此选项。

指定目标云服务的名称。

resourceGroup - 资源组
输入别名： EnvironmentNameRM。 string. 当 ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs 时，需要此选项。

指定目标资源组的名称。

ResourceFilteringMethod - 计算机选择依据
string. 可选。 在 时 Destination = AzureVMs使用 。 允许的值： machineNames (计算机名称) ， tags。 默认值：machineNames。

指定用于标识资源组中 VM 子集的 VM 主机名或标记。 仅通过 Azure 资源管理器创建的资源支持标记。

MachineNames - 筛选条件
string. 可选。 在 时 Destination = AzureVMs使用 。

提供 Azure VM 主机名（例如 ffweb、 ffdb）或标记（例如 Role:DB、 Web、 OS:Win8.1）的列表。

注意：标记的有效分隔符包括 、 (逗号) 、： (冒号) 和 ; (分号) 。 提供多个标记时，任务将仅在包含指定标记的 VM 中运行。 默认情况下，任务在所有 VM 中运行。

vmsAdminUserName - 管理员登录名
string. 当 Destination = AzureVMs 时，需要此选项。

指定 Azure VM 管理员帐户的用户名。

vmsAdminPassword - 密码
string. 当 Destination = AzureVMs 时，需要此选项。

指定 Azure VM 管理员帐户的密码。

有效输入包括生成或发布管道（如 $(passwordVariable)）中定义的变量。 若要保护密码，请将其标记为 secret。

TargetPath - 目标文件夹
string. 当 Destination = AzureVMs 时，需要此选项。

指定目标 VM 上用于从源复制文件的本地路径。

有效输入包括环境变量，例如 $env:windir\BudgetIT\Web。

AdditionalArguments - 其他参数
string.

为 提供在上传到 Blob 或 VM 时将应用的其他参数 AzCopy.exe ， /NC:10例如 。

enableCopyPrerequisites - 启用复制先决条件
boolean. 可选。 在 时 ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs使用 。 默认值：false。

启用后，使用自签名证书在端口 5986 上配置 Windows 远程管理 (WinRM) 侦听器，而不是 HTTPS 协议。 在 Azure VM 上执行复制操作所必需的。 如果目标 VM 使用负载均衡器，请为目标端口配置入站 NAT 规则， (5986) 。 仅适用于 ARM VM。

CopyFilesInParallel - 并行复制
boolean. 可选。 在 时 Destination = AzureVMs使用 。 默认值：true。

接受默认设置会将文件并行复制到目标 VM。

CleanTargetBeforeCopy - 清理目标
boolean. 可选。 在 时 Destination = AzureVMs使用 。 默认值：false。

将 设置为 true 在执行复制操作之前清理目标文件夹。

skipCACheck - 测试证书
boolean. 可选。 在 时 Destination = AzureVMs使用 。 默认值：true。

在通过 HTTPS 进行连接之前，默认值不会验证服务器证书是否由受信任的 CA 签名。

outputStorageUri - 存储容器 URI
string.

指定用于文件复制到的存储容器 URI 的变量的名称。 仅当所选目标是 Azure Blob 时有效。

outputStorageContainerSasToken - 存储容器 SAS 令牌
string.

指定用于访问已复制文件的存储容器 SAS 令牌的变量的名称。 仅当所选目标是 Azure Blob 时有效。

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

要求

要求	说明
管道类型	YAML，经典内部版本，经典版本
运行平台	Agent、DeploymentGroup
需求	自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业：azureps
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任意
可设置的变量	任意
代理版本	1.103.0 或更高版本
任务类别	部署