CopyFiles@1 - Tarefa Copiar Ficheiros v1

Utilize esta tarefa para copiar ficheiros de uma pasta de origem para uma pasta de destino com padrões de correspondência. (Os padrões de correspondência só corresponderão aos caminhos dos ficheiros e não aos caminhos das pastas).

Nota

Existe uma versão mais recente desta 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 ficheiros que pretende copiar. Se a pasta estiver vazia, a tarefa copia ficheiros da pasta raiz do repositório como $(Build.SourcesDirectory) se tivesse sido especificado.

Se a compilação produzir artefactos fora do diretório de origens, especifique $(Agent.BuildDirectory) para copiar ficheiros do diretório criado para o pipeline.

Contents - Conteúdo
string. Obrigatório. Valor predefinido: **.

Os caminhos de ficheiro a incluir como parte da cópia. Esta cadeia suporta múltiplas linhas de padrões de correspondência.

Por exemplo:

• * copia todos os ficheiros na pasta de origem especificada.
• ** copia todos os ficheiros na pasta de origem especificada e todos os ficheiros em todas as subpastas.
• **\bin\** copia todos os ficheiros de forma recursiva a partir de qualquer pasta bin.

O padrão é utilizado para corresponder apenas a caminhos de ficheiros e não a caminhos de pastas. Especifique padrões, como, por **\bin\** exemplo, em vez de **\bin.

Utilize o separador de caminho que corresponde ao tipo de agente de compilação. Por exemplo, / tem de ser utilizado para agentes linux. São apresentados mais exemplos abaixo.

TargetFolder - Pasta de Destino
string. Obrigatório.

A pasta de destino ou o caminho UNC que irá conter os ficheiros copiados. Pode utilizar variáveis. Exemplo: $(build.artifactstagingdirectory).

CleanTargetFolder - Limpar Pasta de Destino
boolean. Valor predefinido: false.

Opcional. Elimina todos os ficheiros existentes na pasta de destino antes do processo de cópia.

OverWrite - Substituir
boolean. Valor predefinido: false.

Opcional. Substitui os ficheiros existentes na pasta de destino.

flattenFolders - Aplanar Pastas
boolean. Valor predefinido: false.

Opcional. Aplana a estrutura de pastas e copia todos os ficheiros para a pasta de destino especificada.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Existe uma versão mais recente desta tarefa disponível em CopyFiles@2.

Se nenhum ficheiro corresponder, a tarefa continuará a reportar êxito. Se já existir um ficheiro correspondente na pasta de destino, a tarefa reportará a falha, a menos que Overwrite esteja definido como verdadeiro.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agent, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.91.0 ou superior
Categoria da tarefa	Utilitário

Ver também

• CopyFiles@2