Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
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.
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.
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.
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 |