WindowsMachineFileCopy@1: tarea copia de archivos de máquina Windows v1

Artículo
07/02/2024

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

Syntax

# Windows machine file copy v1
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

# Windows Machine File Copy v1
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

Entradas

SourcePath - Fuente
string. Obligatorio.

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.

EnvironmentName - Máquinas
string.

Especifica una lista separada por comas de direcciones IP de máquina o FQDN, por ejemplo, dbserver.fabrikam.com,192.168.12.34. También puede especificar la variable de salida de otras tareas, por ejemplo $(variableName).

AdminUserName - Inicio de sesión del administrador
string.

Especifica el inicio de sesión de administrador para las máquinas de destino.

AdminPassword - Contraseña
string.

Especifica la contraseña del inicio de sesión de administrador para las máquinas de destino. Las variables definidas en las definiciones de compilación o versión tal como $(passwordVariable) se aceptan. Puede marcar el tipo de variable como secret para protegerlo.

TargetPath - Carpeta de destino
string. Obligatorio.

Especifica la ruta de acceso local en el equipo 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.

Limpia la carpeta de destino antes de copiar los archivos.

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

Copia los archivos en paralelo a las máquinas.

AdditionalArguments - Argumentos adicionales
string.

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

ResourceFilteringMethod - Seleccionar máquinas por
string. Valores permitidos: machineNames (nombres de máquina), tags. Valor predeterminado: machineNames.

MachineNames - Criterios de filtro
string.

Esta entrada solo es válida para grupos de máquinas y aún no se admite para una lista plana de máquinas o variables de salida.

Especifica una lista separada por comas de máquinas, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34, o etiquetas, como Role:DB; OS:Win8.1. Si se proporcionan varias etiquetas, la tarea se ejecutará en todas las máquinas con las etiquetas especificadas. El valor predeterminado ejecuta la tarea en todas las máquinas.

Opciones de control de tareas

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

Variables de salida

Ninguno.

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