WindowsMachineFileCopy@2: tarea copia de archivos de máquina Windows v2

Artículo
07/02/2024

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.

# 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 - Fuente
string. Obligatorio.

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 en 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 máquina o FQDN, que opcionalmente incluye 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 máquina o FQDN, que opcionalmente incluye 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.

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

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

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

AdminPassword - Contraseña
string. Obligatorio.

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

AdminPassword - Contraseña
string.

TargetPath - Carpeta de destino
string. Obligatorio.

Especifica la ruta de acceso local en las máquinas de destino o una ruta de acceso UNC accesible para copiar los archivos desde el origen, como d:\fabrikam o \\fabrikam\Web.

CleanTargetBeforeCopy - Limpiar destino
boolean. Valor predeterminado: false.

Elimina todos los archivos de la carpeta de destino antes de copiarlos.

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

Copia archivos en todas las máquinas de destino en paralelo, lo que puede acelerar el proceso de copia.

AdditionalArguments - Argumentos adicionales
string.

Especifica argumentos adicionales de RoboCopy 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 tareas. 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 de PowerShell-DSC, que son necesarios para instalar la aplicación en máquinas Windows. Usa RoboCopy, la utilidad de línea de comandos creada para la copia rápida de datos.

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

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

Novedades de la versión 2.0

Se está agregando compatibilidad con 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
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.104.0 o superior
Categoría de la tarea:	Implementación

Compartir vía