Compartilhar via

WindowsMachineFileCopy@2 – Tarefa de cópia de arquivo do computador Windows v2

  • Artigo

Use essa tarefa para copiar arquivos para computadores Windows remotos.

Sintaxe

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    MachineNames: # string. Required. Machines. 
    AdminUserName: # string. Required. Admin Login. 
    AdminPassword: # string. Required. 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.

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # 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.

# Windows Machine File Copy v2
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # 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.

Entradas

SourcePath - Fonte
string. Obrigatórios.

O caminho para os arquivos a serem copiados. Especifica o caminho absoluto da pasta ou arquivo de origem no computador local ou um compartilhamento UNC, como c:\fabrikamfiber ou \\fabrikamshare\fabrikamfiber. Você pode usar variáveis de sistema predefinidas, como $(Build.Repository.LocalPath) (a pasta de trabalho no computador do agente), o que facilita a especificação do local dos artefatos de build no computador que hospeda o agente de automação.


MachineNames - Máquinas
string. Obrigatórios.

Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs, incluindo opcionalmente o número da porta.
Por exemplo: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 você também pode especificar a variável de saída de outras tarefas, por exemplo $(variableName), ou pode usar o nome de um Grupo de Recursos do Azure.


MachineNames - Máquinas
string.

Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs, incluindo opcionalmente o número da porta. Por exemplo: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Você também pode especificar a variável de saída de outras tarefas, por exemplo $(variableName), ou pode usar o nome de um Grupo de Recursos do Azure.


AdminUserName - Logon do Administração
string. Obrigatórios.

Especifica o nome de usuário de um domínio ou uma conta administrativa local nos hostes de destino. Há suporte para formatos como domain\username, username e machine-name\username . Não há suporte para formatos UPN, como username@domain.com, e contas de sistema internas, como NT Authority\System.


AdminUserName - Logon do Administração
string.

Especifica o nome de usuário de um domínio ou uma conta administrativa local nos hostes de destino. Há suporte para formatos como domain\username, username e machine-name\username . Não há suporte para formatos UPN, como username@domain.com, e contas de sistema internas, como NT Authority\System.


AdminPassword - Senha
string. Obrigatórios.

Especifica a senha do logon do administrador para os computadores de destino. Variáveis definidas em pipelines de build ou de lançamento, como $(passwordVariable), são aceitas. Você pode marcar a variável como secret para protegê-la.


AdminPassword - Senha
string.

Especifica a senha do logon do administrador para os computadores de destino. Variáveis definidas em pipelines de build ou de lançamento, como $(passwordVariable), são aceitas. Você pode marcar a variável como secret para protegê-la.


TargetPath - Pasta de Destino
string. Obrigatórios.

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


CleanTargetBeforeCopy - Destino Limpo
boolean. Valor padrão: false.

Exclui todos os arquivos na pasta de destino antes de copiar os novos arquivos para ela.


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

Copia arquivos para todos os computadores de destino em paralelo, o que pode acelerar o processo de cópia.


AdditionalArguments - Argumentos adicionais
string.

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


Opções de controle de 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

Use essa tarefa para copiar arquivos de aplicativo e outros artefatos, como scripts do PowerShell e módulos do PowerShell-DSC, que são necessários para instalar o aplicativo em computadores Windows. Ele usa o RoboCopy, o utilitário de linha de comando criado para cópia rápida de dados.

Por que recebo um erro de sistema 53 ao usar essa tarefa?

Normalmente, isso ocorre quando o caminho especificado não pode ser localizado. Isso pode ser devido a um firewall bloqueando as portas necessárias para o compartilhamento de arquivos e impressoras ou uma especificação de caminho inválida. Para obter mais detalhes, consulte Erro 53 no TechNet.

Novidades na versão 2.0

  • O suporte a proxy está sendo adicionado.
  • Foi removido o suporte de computadores DTL herdados.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
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.104.0 ou superior
Categoria da tarefa Implantar