Compartilhar via


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

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.

Entradas

SourcePath - de origem
string. Obrigatório

O caminho para os arquivos a serem copiados. Especifica o caminho absoluto da pasta ou arquivo de origem no computador local ou em 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.


máquinas MachineNames -
string. Obrigatório

Especifica uma lista separada por vírgulas de endereços IP ou FQDNs do computador, 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.


de Logon do Administrador do AdminUserName -
string. Obrigatório

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


AdminPassword - de senha
string. Obrigatório

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


da Pasta de Destino TargetPath -
string. Obrigatório

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


CleanTargetBeforeCopy - de 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 paralelas
boolean. Valor padrão: true.

Copia arquivos para todas as máquinas de destino em paralelo, o que pode acelerar o processo de cópia.


AdditionalArguments - argumentos adicionais
string.

Especifica argumentos RoboCopy adicionais 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 das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Use essa tarefa para copiar arquivos de aplicativo e outros artefatos, como scripts do PowerShell e módulos 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 esta 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 compartilhamento de arquivos e impressoras ou uma especificação de caminho inválida. Para obter mais detalhes, consulte Erro 53 no TechNet.

O que há de novo na versão 2.0

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

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 1.104.0 ou superior
Categoria de tarefa Implantar