Partilhar via

WindowsMachineFileCopy@2 - Tarefa Windows machine file copy v2

Use esta tarefa para copiar arquivos para máquinas Windows remotas.

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.

Insumos

SourcePath - de origem
string. Obrigatório

O caminho para os arquivos a serem copiados. Especifica o caminho absoluto da pasta ou arquivo de origem na máquina 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 compilação no computador que hospeda o agente de automação.


MachineNames - Máquinas
string. Obrigatório

Especifica uma lista separada por vírgulas de endereços IP ou FQDNs da máquina, 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 ou FQDNs da máquina, 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 - de login de administrador
string. Obrigatório

Especifica o nome de usuário de um domínio ou de uma conta administrativa local no(s) host(s) de destino. Formatos como domínio\nome de usuário, nome de usuário e nome da máquina\nome de usuário são suportados. Não há suporte para formatos UPN, como username@domain.com, e contas de sistema internas, como NT Authority\System.


AdminUserName - de login de administrador
string.

Especifica o nome de usuário de um domínio ou de uma conta administrativa local no(s) host(s) de destino. Formatos como domínio\nome de usuário, nome de usuário e nome da máquina\nome de usuário são suportados. Não há suporte para formatos UPN, como username@domain.com, e contas de sistema internas, como NT Authority\System.


AdminPassword - Palavra-passe
string. Obrigatório

Especifica a senha para o login de administrador para as máquinas de destino. As variáveis definidas em pipelines de compilação ou liberação, como $(passwordVariable), são aceitas. Você pode marcar a variável como secret para protegê-la.


AdminPassword - Palavra-passe
string.

Especifica a senha para o login de administrador para as máquinas de destino. As variáveis definidas em pipelines de compilação ou liberação, como $(passwordVariable), são aceitas. Você pode marcar a variável como secret para protegê-la.


TargetPath - pasta de destino
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 - Alvo Limpo
boolean. Valor predefinido: false.

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


CopyFilesInParallel - Copiar arquivos em paralelo
boolean. Valor predefinido: 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 controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Use esta 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 máquinas Windows. Ele usa RoboCopy, o utilitário de linha de comando construído 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 o compartilhamento de arquivos e impressoras ou a 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.
  • Removido o suporte de máquinas DTL herdadas.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Desplegar