WindowsMachineFileCopy@2 - Cópia de ficheiros de máquina do Windows v2

Artigo
07/02/2024

Utilize esta tarefa para copiar ficheiros para máquinas remotas do Windows.

Syntax

# 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ório.

O caminho para os ficheiros para copiar. Especifica o caminho absoluto da pasta de origem ou ficheiro na máquina local ou numa UnC Share, como c:\fabrikamfiber ou .\\fabrikamshare\fabrikamfiber Pode utilizar variáveis de sistema predefinidas, tais como $(Build.Repository.LocalPath) (a pasta de trabalho no computador do agente), o que facilita a especificação da localização dos artefactos de construção no computador que acolhe o agente de automação.

MachineNames - Máquinas
string. Obrigatório.

Especifica uma lista separada por vírgula de endereços IP da máquina ou FQDNs, incluindo opcionalmente o número da porta.
Por exemplo: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 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 Azure.

MachineNames - Máquinas
string.

Especifica uma lista separada por vírgula de endereços IP da máquina ou FQDNs, incluindo opcionalmente o número da porta. Por exemplo: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. 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 Azure.

AdminUserName - Administração Início de Sessão
string. Obrigatório.

Especifica o nome de utilizador de um domínio ou de uma conta administrativa local no(s) anfitrião-alvo. São suportados formatos como o nome de utilizador\de domínio, nome de utilizador e nome de utilizador\userme . Os formatos UPN, tais como username@domain.com, e contas de sistema incorporadas, como NT Authority\System, não são suportados.

AdminUserName - Administração Início de Sessão
string.

AdminPassword - Senha
string. Obrigatório.

Especifica a palavra-passe para o login do administrador para as máquinas-alvo. São aceites variáveis definidas em oleodutos de construção ou libertação, tais como $(passwordVariable). Pode marcar a variável para secret a proteger.

AdminPassword - Senha
string.

TargetPath - Pasta de destino
string. Obrigatório.

Especifica o percurso local nas máquinas-alvo ou um caminho unc acessível para copiar os ficheiros da fonte, como d:\fabrikam ou \\fabrikam\Web.

CleanTargetBeforeCopy - Alvo limpo
boolean. Valor predefinido: false.

Elimina todos os ficheiros na pasta alvo antes de copiar os novos ficheiros para o mesmo.

CopyFilesInParallel - Copiar ficheiros em paralelo
boolean. Valor predefinido: true.

Copia ficheiros a todas as máquinas-alvo em paralelo, o que pode acelerar o processo de cópia.

AdditionalArguments - Argumentos adicionais
string.

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

Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para copiar ficheiros de aplicações e outros artefactos, tais como scripts PowerShell e módulos PowerShell-DSC, que são necessários para instalar a aplicação em máquinas Windows. Utiliza o RoboCopy, o utilitário de linha de comando construído para uma rápida cópia de dados.

Por que tenho um erro de sistema 53 ao usar esta tarefa?

Normalmente isto ocorre quando o caminho especificado não pode ser localizado. Isto pode dever-se a uma firewall que bloqueia as portas necessárias para a partilha de ficheiros e impressoras ou uma especificação de caminho inválida. Para mais detalhes, consulte Error 53 na TechNet.

Novidades na versão 2.0

O apoio à procuração está a ser adicionado.
Removido suporte de máquinas DTL antigas.

Requisitos

Requisito	Description
Tipos de gasodutos	YAML, Construção clássica, lançamento clássico
Continua	Agente, Grupo de Implementação
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis de configuração	Qualquer
Versão do agente	1.104.0 ou maior
Categoria da tarefa	Implementação

Partilhar via