WindowsMachineFileCopy@1 - Tâche de copie de fichiers d’ordinateur Windows v1

Article
07/02/2024

Utilisez cette tâche pour copier des fichiers sur des ordinateurs Windows distants.

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.

Entrées

SourcePath - Source
string. Obligatoire.

Spécifie le chemin absolu du dossier ou du fichier source sur l’ordinateur local ou un partage UNC, comme c:\fabrikamfiber ou \\fabrikamshare\fabrikamfiber.

EnvironmentName - Machines
string.

Spécifie une liste séparée par des virgules d’adresses IP ou de noms de domaine complets de l’ordinateur, par exemple . dbserver.fabrikam.com,192.168.12.34 Vous pouvez également spécifier la variable de sortie d’autres tâches, par exemple $(variableName).

AdminUserName - Connexion administrateur
string.

Spécifie la connexion administrateur pour les ordinateurs cibles.

AdminPassword - Mot de passe
string.

Spécifie le mot de passe de la connexion administrateur pour les ordinateurs cibles. Les variables définies dans les définitions de build/mise en production sont $(passwordVariable) acceptées. Vous pouvez marquer le type de variable comme secret pour le sécuriser.

TargetPath - Dossier de destination
string. Obligatoire.

Spécifie le chemin d’accès local sur l’ordinateur cible 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.

Nettoie le dossier de destination avant de copier les fichiers.

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

Copie des fichiers en parallèle sur les machines.

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.

ResourceFilteringMethod - Sélectionner les machines par
string. Valeurs autorisées : machineNames (Noms des ordinateurs), tags. Valeur par défaut : machineNames.

MachineNames - Critères de filtre
string.

Cette entrée est uniquement valide pour les groupes d’ordinateurs et n’est pas encore prise en charge pour une liste plate de machines ou de variables de sortie.

Spécifie une liste de machines séparées par des virgules, comme dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34, ou des balises, comme Role:DB; OS:Win8.1. Si plusieurs balises sont fournies, la tâche s’exécute sur tous les ordinateurs avec les balises spécifiées. La valeur par défaut exécute la tâche sur tous les ordinateurs.

Options de contrôle de la tâche

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

Variables de sortie

Aucun.

Configuration requise

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

Partage via