WindowsMachineFileCopy@1 – Tarefa de cópia v1 do arquivo de computador do Windows

Artigo
07/02/2024

Use esta tarefa para copiar arquivos para computadores Windows remotos.

Syntax

# Windows machine file copy v1
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

# Windows Machine File Copy v1
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

Entradas

SourcePath - Fonte
string. Obrigatórios.

Especifica o caminho absoluto da pasta ou arquivo de origem no computador local ou um compartilhamento UNC, como c:\fabrikamfiber ou \\fabrikamshare\fabrikamfiber.

EnvironmentName - Máquinas
string.

Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs, por exemplo, dbserver.fabrikam.com,192.168.12.34. Você também pode especificar a variável de saída de outras tarefas, por exemplo $(variableName).

AdminUserName - Logon de administrador
string.

Especifica o logon do administrador para os computadores de destino.

AdminPassword - Senha
string.

Especifica a senha para o logon do administrador para os computadores de destino. Variáveis definidas em definições de build/versão conforme $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-lo.

TargetPath - Pasta de Destino
string. Obrigatórios.

Especifica o caminho local no computador de destino ou um caminho UNC acessível para copiar os arquivos da origem, como d:\fabrikam ou \\fabrikam\Web.

CleanTargetBeforeCopy - Limpar destino
boolean. Valor padrão: false.

Limpa a pasta de destino antes de copiar os arquivos.

CopyFilesInParallel - Copiar arquivos em paralelo
boolean. Valor padrão: true.

Copia arquivos em paralelo para os computadores.

AdditionalArguments - Argumentos adicionais
string.

Especifica argumentos robocopy adicionais que são aplicados ao copiar arquivos, como /min:33553332 /l.

ResourceFilteringMethod - Selecionar computadores por
string. Valores permitidos: machineNames (Nomes de Máquina), tags. Valor padrão: machineNames.

MachineNames - Critérios de Filtro
string.

Essa entrada só é válida para grupos de computadores e ainda não tem suporte para uma lista simples de computadores ou variáveis de saída.

Especifica uma lista separada por vírgulas de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34ou marcas, como Role:DB; OS:Win8.1. Se várias marcas forem fornecidas, a tarefa será executada em todos os computadores com as marcas especificadas. O padrão executa a tarefa em todos os computadores.

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.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
É executado em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	1.104.0 ou superior
Categoria da tarefa	Implantar

Compartilhar via