AzureFileCopy@2 - Tarefa de cópia de arquivo do Azure v2

2025-06-24

Copie arquivos para o Armazenamento de Blobs do Azure ou máquinas virtuais.

Esta tarefa foi preterida, pois esta versão da tarefa AzureFileCopy utiliza uma versão desativada do AzCopy. Use a versão mais recente da tarefa AzureFileCopy. Consulte Guia de Migração do AzCopy para v8 a v10.

Observação

Esta tarefa não suporta autenticação do Azure Resource Manager com federação de identidade de fluxo de trabalho.

Copie arquivos para o Armazenamento de Blobs do Azure ou máquinas virtuais.

Observação

Esta tarefa não suporta autenticação do Azure Resource Manager com federação de identidade de fluxo de trabalho.

Sintaxe

# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
  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. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #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.

Insumos

SourcePath - de origem
string. Obrigatório.

Especifique o caminho absoluto para a pasta de origem, o arquivo na máquina local ou um compartilhamento UNC. O valor ou expressão especificado deve retornar um único nome de pasta ou um nome de arquivo.

azureConnectionType - Tipo de Conexão do Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valor padrão: ConnectedServiceNameARM.

Especifique o tipo de conexão do Azure.

azureClassicSubscription - de Subscrição Clássica do Azure
Alias de entrada: ConnectedServiceName. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique a assinatura de destino do Azure Classic.

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceNameARM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique a assinatura de destino do Azure Resource Manager.

Destination - Tipo de destino
string. Obrigatório. Valores permitidos: AzureBlob (Blob do Azure), AzureVMs (VMs do Azure).

Especifique o tipo de destino a ser usado para copiar os arquivos.

classicStorage - Conta de armazenamento clássica
Alias de entrada: StorageAccount. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique uma conta de armazenamento clássica pré-existente. Esta é a conta de armazenamento usada como intermediário para copiar arquivos para VMs do Azure.

storage - de Conta de Armazenamento RM
Alias de entrada: StorageAccountRM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique uma conta de armazenamento ARM pré-existente. Esta é a conta de armazenamento usada como intermediário para copiar arquivos para VMs do Azure.

ContainerName - nome do contêiner
string. Necessário quando Destination = AzureBlob.

Especifique o nome do contêiner no qual os arquivos são copiados. Se o contêiner especificado não existir na conta de armazenamento, ele será criado.

Para criar um diretório virtual dentro do contêiner, use a entrada do prefixo Blob. Por exemplo, para o local de destino https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/, especifique o nome do contêiner mycontainer e o prefixo de Blob vd1/vd2.

BlobPrefix - Prefixo de Blob
string. Opcional. Use quando Destination = AzureBlob.

Especifique um prefixo que possa ser usado para filtrar arquivos.

Exemplo: Você pode acrescentar um número de compilação para filtrar os arquivos de todos os Blobs com o mesmo número de compilação.

Exemplo: Se você especificar um prefixo de Blob myvd1, um diretório virtual será criado dentro do contêiner. Os arquivos são copiados da fonte para https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - de serviço na nuvem
Alias de entrada: EnvironmentName. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Especifique o nome do Serviço de Nuvem de destino.

resourceGroup - Grupo de Recursos
Alias de entrada: EnvironmentNameRM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Especifique o nome do Grupo de Recursos de destino.

ResourceFilteringMethod - Selecionar máquinas por
string. Opcional. Use quando Destination = AzureVMs. Valores permitidos: machineNames (Nomes de máquinas), tags. Valor padrão: machineNames.

Especifique o nome do host da VM ou a marca que identifica um subconjunto de VMs em um grupo de recursos. Tags são suportadas apenas para recursos criados por meio do Azure Resource Manager.

MachineNames - Critérios de Filtro
string. Opcional. Use quando Destination = AzureVMs.

Forneça uma lista de nomes de host de VM do Azure, como ffweb, ffdbou marcas como Role:DB, Web, OS:Win8.1.

Nota: Os delimitadores válidos para tags incluem ,(vírgula), :(dois-pontos) e ;(ponto-e-vírgula). Ao fornecer várias tags, a tarefa será executada em todas as VMs que contêm as tags especificadas. Por padrão, a tarefa é executada em todas as VMs.

vmsAdminUserName - de login de administrador
string. Necessário quando Destination = AzureVMs.

Forneça o nome de usuário da conta de administrador da VM do Azure.

vmsAdminPassword - Palavra-passe
string. Necessário quando Destination = AzureVMs.

Forneça a senha para a conta de administrador da VM do Azure.

A entrada válida inclui variáveis definidas em pipelines de compilação ou liberação, como $(passwordVariable). Para proteger uma palavra-passe, marque-a como secret.

TargetPath - pasta de destino
string. Necessário quando Destination = AzureVMs.

Especifique o caminho local nas VMs de destino.

A entrada válida inclui variáveis de ambiente como $env:windir\BudgetIT\Web.

AdditionalArgumentsForBlobCopy - Argumentos opcionais (para carregar arquivos para blob)
string.

Forneça argumentos adicionais para AzCopy.exe que podem ser aplicados ao carregar para Blobs, como /NC:10.

Se nenhum argumento opcional for especificado, os argumentos a seguir serão adicionados por padrão.

/Y
/SetContentType
/Z
/V
/S - Adicionado quando o nome do contêiner não é $root.
/BlobType:page - Adicionado quando a conta de armazenamento especificada é uma conta premium.
/Pattern - Adicionado quando o caminho de origem é um arquivo. Incluído com quaisquer outros argumentos opcionais especificados.

AdditionalArgumentsForVMCopy - Argumentos opcionais (para baixar arquivos para VM)
string. Opcional. Use quando Destination = AzureVMs.

Forneça argumentos adicionais para AzCopy.exe que podem ser aplicados ao fazer o download para VMs, como /NC:10.

Se nenhum argumento opcional for especificado, os seguintes itens serão adicionados por padrão.

/Y
/S
/Z
/V

enableCopyPrerequisites - Ativar pré-requisitos de cópia
boolean. Opcional. Use quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Valor padrão: false.

Quando habilitado, usa um certificado autoassinado para configurar um ouvinte de Gerenciamento Remoto do Windows (WinRM) na porta 5986 em vez do protocolo HTTPS. Necessário para executar operações de cópia em VMs do Azure. Se as VMs de destino usarem um balanceador de carga, configure as regras NAT de entrada para a porta de destino (5986). Aplica-se apenas a VMs ARM.

CopyFilesInParallel - Cópia em paralelo
boolean. Opcional. Use quando Destination = AzureVMs. Valor padrão: true.

Aceitar a configuração padrão copia os arquivos em paralelo com as VMs de destino.

CleanTargetBeforeCopy - Alvo Limpo
boolean. Opcional. Use quando Destination = AzureVMs. Valor padrão: false.

Definir esse valor como true limpa a pasta de destino antes de executar a ação de cópia.

skipCACheck - Certificado de Teste
boolean. Opcional. Use quando Destination = AzureVMs. Valor padrão: true.

O valor padrão não validará se o certificado do servidor foi assinado por uma CA confiável antes de se conectar por HTTPS.

URI do contêiner de armazenamento outputStorageUri -
string.

Especifique o nome da variável usada para o URI do contêiner de armazenamento para o qual os arquivos foram copiados. Válido somente quando o destino selecionado for um Blob do Azure.

de token SAS do contêiner de armazenamento outputStorageContainerSasToken -
string.

Especifique o nome da variável usada para o token SAS do contêiner de armazenamento que acessa os arquivos que foram copiados. Válido somente quando o destino selecionado for um Blob do Azure.

Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

O que há de novo na versão 2.0: Usando a versão mais recente do AzCopy.

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: azureps
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	1.103.0 ou superior
Categoria de tarefa	Desplegar