CopyFiles@1 – Tarefa Copiar Arquivos v1

Use essa tarefa para copiar arquivos de uma pasta de origem para uma pasta de destino usando padrões de correspondência. (Os padrões de correspondência corresponderão apenas a caminhos de arquivo, não a caminhos de pasta).

Observação

Há uma versão mais recente dessa tarefa disponível em CopyFiles@2.

Syntax

# Copy Files v1
# Copy files from source folder to target folder using minimatch patterns (The minimatch patterns will only match file paths, not folder paths).
- task: CopyFiles@1
  inputs:
    #SourceFolder: # string. Source Folder. 
    Contents: '**' # string. Required. Contents. Default: **.
    TargetFolder: # string. Required. Target Folder. 
  # Advanced
    #CleanTargetFolder: false # boolean. Clean Target Folder. Default: false.
    #OverWrite: false # boolean. Overwrite. Default: false.
    #flattenFolders: false # boolean. Flatten Folders. Default: false.

Entradas

SourceFolder - Pasta de Origem
string.

Opcional. A pasta que contém os arquivos que você deseja copiar. Se a pasta estiver vazia, a tarefa copiará arquivos da pasta raiz do repositório como se tivesse $(Build.SourcesDirectory) sido especificado.

Se o build produzir artefatos fora do diretório de fontes, especifique $(Agent.BuildDirectory) para copiar arquivos do diretório criado para o pipeline.


Contents - Conteúdo
string. Obrigatórios. Valor padrão: **.

Os caminhos de arquivo a serem incluídos como parte da cópia. Essa cadeia de caracteres dá suporte a várias linhas de padrões de correspondência.

Por exemplo:

  • * copia todos os arquivos na pasta de origem especificada.
  • ** copia todos os arquivos na pasta de origem especificada e todos os arquivos em todas as subpastas.
  • **\bin\** copia todos os arquivos recursivamente de qualquer pasta bin.

O padrão é usado para corresponder apenas a caminhos de arquivo, não a caminhos de pasta. Especifique padrões, como **\bin\** em vez de **\bin.

Use o separador de caminho que corresponde ao tipo de agente de build. Por exemplo, / deve ser usado para agentes do Linux. Mais exemplos são mostrados abaixo.


TargetFolder - Pasta de Destino
string. Obrigatórios.

A pasta de destino ou o caminho UNC que conterá os arquivos copiados. Você pode usar variáveis. Exemplo: $(build.artifactstagingdirectory).


CleanTargetFolder - Limpar Pasta de Destino
boolean. Valor padrão: false.

Opcional. Exclui todos os arquivos existentes na pasta de destino antes do processo de cópia.


OverWrite - Substituir
boolean. Valor padrão: false.

Opcional. Substitui os arquivos existentes na pasta de destino.


flattenFolders - Nivelar Pastas
boolean. Valor padrão: false.

Opcional. Nivela a estrutura de pastas e copia todos os arquivos para a pasta de destino especificada.


Opções de controle da tarefa

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

Variáveis de saída

Nenhum.

Comentários

Há uma versão mais recente dessa tarefa disponível em CopyFiles@2.

Se nenhum arquivo corresponder, a tarefa ainda relatará êxito. Se um arquivo correspondente já existir na pasta de destino, a tarefa relatará uma falha, a menos que Overwrite esteja definida como true.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.91.0 ou superior
Categoria da tarefa Utilitário

Confira também