Compartir a través de


WindowsMachineFileCopy@2 - Tarea de copia de archivos de máquina de Windows v2

Use esta tarea para copiar archivos en máquinas Windows remotas.

Sintaxis

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

Entradas

SourcePath - origen
string. Obligatorio.

La ruta de acceso a los archivos que se van a copiar. Especifica la ruta de acceso absoluta de la carpeta o archivo de origen en el equipo local o un recurso compartido UNC, como c:\fabrikamfiber o \\fabrikamshare\fabrikamfiber. Puede usar variables de sistema predefinidas, como $(Build.Repository.LocalPath) (la carpeta de trabajo en el equipo del agente), lo que facilita la especificación de la ubicación de los artefactos de compilación en el equipo que hospeda el agente de automatización.


MachineNames - Máquinas
string. Obligatorio.

Especifica una lista separada por comas de direcciones IP de equipo o FQDN, que incluye opcionalmente el número de puerto.
Por ejemplo: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 también puede especificar la variable de salida de otras tareas, por ejemplo $(variableName), o puede usar el nombre de un grupo de recursos de Azure.


MachineNames - Máquinas
string.

Especifica una lista separada por comas de direcciones IP de equipo o FQDN, que incluye opcionalmente el número de puerto. Por ejemplo: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. También puede especificar la variable de salida de otras tareas, por ejemplo $(variableName), o puede usar el nombre de un grupo de recursos de Azure.


de inicio de sesión de administrador de AdminUserName -
string. Obligatorio.

Especifica el nombre de usuario de un dominio o una cuenta administrativa local en los hosts de destino. Se admiten formatos como dominio\nombre de usuario, nombre de usuario y nombre de equipo\nombre de usuario . No se admiten los formatos UPN, como username@___domain.com, y las cuentas del sistema integradas, como NT Authority\System.


de inicio de sesión de administrador de AdminUserName -
string.

Especifica el nombre de usuario de un dominio o una cuenta administrativa local en los hosts de destino. Se admiten formatos como dominio\nombre de usuario, nombre de usuario y nombre de equipo\nombre de usuario . No se admiten los formatos UPN, como username@___domain.com, y las cuentas del sistema integradas, como NT Authority\System.


de contraseña de AdminPassword -
string. Obligatorio.

Especifica la contraseña para el inicio de sesión de administrador para las máquinas de destino. Se aceptan las variables definidas en las canalizaciones de compilación o versión, como $(passwordVariable). Puede marcar la variable como secret para asegurarla.


de contraseña de AdminPassword -
string.

Especifica la contraseña para el inicio de sesión de administrador para las máquinas de destino. Se aceptan las variables definidas en las canalizaciones de compilación o versión, como $(passwordVariable). Puede marcar la variable como secret para asegurarla.


carpeta de destino de TargetPath -
string. Obligatorio.

Especifica la ruta de acceso local en los equipos de destino o una ruta de acceso UNC accesible para copiar los archivos del origen, como d:\fabrikam o \\fabrikam\Web.


CleanTargetBeforeCopy - de destino limpio
boolean. Valor predeterminado: false.

Elimina todos los archivos de la carpeta de destino antes de copiar los nuevos archivos en ella.


CopyFilesInParallel - copiar archivos en en paralelo
boolean. Valor predeterminado: true.

Copia archivos en todos los equipos de destino en paralelo, lo que puede acelerar el proceso de copia.


AdditionalArguments - argumentos adicionales
string.

Especifica los argumentos RoboCopy adicionales que se aplican al copiar archivos, como /min:33553332 /l.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para copiar archivos de aplicación y otros artefactos, como scripts de PowerShell y módulos PowerShell-DSC, que son necesarios para instalar la aplicación en equipos Windows. Utiliza RoboCopy, la utilidad de línea de comandos creada para la copia rápida de datos.

¿Por qué recibo un error del sistema 53 al usar esta tarea?

Normalmente, esto ocurre cuando no se puede localizar la ruta especificada. Esto puede deberse a que un firewall bloquea los puertos necesarios para el uso compartido de archivos e impresoras o a una especificación de ruta no válida. Para obtener más información, consulte Error 53 en TechNet.

Novedades de la versión 2.0

  • Se está agregando soporte de proxy.
  • Se ha quitado la compatibilidad de las máquinas DTL heredadas.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Demandas Ninguno
Capacidades Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Cualquiera
variables settable Cualquiera
Versión del agente 1.104.0 o superior
Categoría de tarea Desplegar