WindowsMachineFileCopy@2 - Tâche de copie de fichier d’ordinateur Windows v2

Article
06/11/2024

Utilisez cette tâche pour copier des fichiers sur des machines Windows distantes.

Syntax

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

Entrées

SourcePath - Source
string. Obligatoire.

Chemin d’accès aux fichiers à copier. Spécifie le chemin d’accès absolu du dossier ou du fichier source sur l’ordinateur local ou un partage UNC, comme c:\fabrikamfiber ou \\fabrikamshare\fabrikamfiber. Vous pouvez utiliser des variables système prédéfinies, telles que $(Build.Repository.LocalPath) (le dossier de travail sur l’ordinateur de l’agent), ce qui facilite la spécification de l’emplacement des artefacts de build sur l’ordinateur qui héberge l’agent Automation.

MachineNames - Machines
string. Obligatoire.

Spécifie une liste séparée par des virgules d’adresses IP ou de noms de domaine complets de l’ordinateur, y compris éventuellement le numéro de port.
Par exemple : dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 vous pouvez également spécifier la variable de sortie d’autres tâches, par exemple $(variableName), ou utiliser le nom d’un groupe de ressources Azure.

MachineNames - Machines
string.

Spécifie une liste séparée par des virgules d’adresses IP ou de noms de domaine complets de l’ordinateur, y compris éventuellement le numéro de port. Par exemple : dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Vous pouvez également spécifier la variable de sortie d’autres tâches, par exemple $(variableName), ou utiliser le nom d’un groupe de ressources Azure.

AdminUserName - connexion Administration
string. Obligatoire.

Spécifie le nom d’utilisateur d’un domaine ou d’un compte d’administration local sur le ou les hôtes cibles. Les formats tels que domain\username, username et machine-name\username sont pris en charge. Les formats UPN, tels que username@domain.com, et les comptes système intégrés, tels que NT Authority\System, ne sont pas pris en charge.

AdminUserName - connexion Administration
string.

AdminPassword - Mot de passe
string. Obligatoire.

Spécifie le mot de passe de la connexion administrateur pour les machines cibles. Les variables définies dans les pipelines de build ou de mise en production, telles que $(passwordVariable), sont acceptées. Vous pouvez marquer la variable comme secret pour la sécuriser.

AdminPassword - Mot de passe
string.

TargetPath - Dossier de destination
string. Obligatoire.

Spécifie le chemin d’accès local sur les machines cibles ou un chemin UNC accessible pour copier les fichiers à partir de la source, comme d:\fabrikam ou \\fabrikam\Web.

CleanTargetBeforeCopy - Nettoyer la cible
boolean. Valeur par défaut : false.

Supprime tous les fichiers du dossier cible avant de copier les nouveaux fichiers dans celui-ci.

CopyFilesInParallel - Copier des fichiers en parallèle
boolean. Valeur par défaut : true.

Copie des fichiers sur toutes les machines cibles en parallèle, ce qui peut accélérer le processus de copie.

AdditionalArguments - Arguments supplémentaires
string.

Spécifie des arguments RoboCopy supplémentaires qui sont appliqués lors de la copie de fichiers, comme /min:33553332 /l.

Options de contrôle des tâches

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour copier des fichiers d’application et d’autres artefacts, tels que des scripts PowerShell et des modules PowerShell-DSC, qui sont nécessaires pour installer l’application sur des ordinateurs Windows. Il utilise RoboCopy, l’utilitaire en ligne de commande conçu pour la copie rapide des données.

Pourquoi est-ce que je reçois une erreur système 53 lors de l’utilisation de cette tâche ?

Cela se produit généralement lorsque le chemin spécifié ne peut pas être localisé. Cela peut être dû à un pare-feu bloquant les ports nécessaires pour le partage de fichiers et d’imprimantes ou à une spécification de chemin d’accès non valide. Pour plus d’informations, consultez Erreur 53 sur TechNet.

Nouveautés de la version 2.0

La prise en charge du proxy est ajoutée.
Suppression de la prise en charge des machines DTL héritées.

Spécifications

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Aucun
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.104.0 ou version ultérieure
Catégorie de la tâche	Déployer

Partage via