Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |