WindowsMachineFileCopy@1: Aufgabe "Dateikopien v1" für Windows-Computer

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um Dateien auf Windows-Remotecomputer zu kopieren.

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.

Eingaben

SourcePath - Quelle
string. Erforderlich.

Gibt den absoluten Pfad des Quellordners oder der Quelldatei auf dem lokalen Computer oder einer UNC-Freigabe an, z c:\fabrikamfiber . B. oder \\fabrikamshare\fabrikamfiber.

EnvironmentName - Maschinen
string.

Gibt eine durch Trennzeichen getrennte Liste von Computer-IP-Adressen oder FQDNs an, z. B dbserver.fabrikam.com,192.168.12.34. . Sie können auch die Ausgabevariable anderer Aufgaben angeben, z. B $(variableName). .

AdminUserName - Admin Anmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.

AdminPassword - Passwort
string.

Gibt das Kennwort für die Administratoranmeldung für die Zielcomputer an. In Build-/Releasedefinitionen definierte Variablen werden akzeptiert $(passwordVariable) . Sie können den Variablentyp als secret markieren, um ihn zu schützen.

TargetPath - Zielordner
string. Erforderlich.

Gibt den lokalen Pfad auf dem Zielcomputer oder einen zugänglichen UNC-Pfad zum Kopieren der Dateien aus der Quelle an, z d:\fabrikam . B. oder \\fabrikam\Web.

CleanTargetBeforeCopy - Bereinigen des Ziels
boolean. Standardwert. false.

Bereinigt den Zielordner vor dem Kopieren der Dateien.

CopyFilesInParallel - Paralleles Kopieren von Dateien
boolean. Standardwert. true.

Kopiert Dateien parallel auf die Computer.

AdditionalArguments - Zusätzliche Argumente
string.

Gibt zusätzliche Robocopy-Argumente an, die beim Kopieren von Dateien angewendet werden, z. B /min:33553332 /l. .

ResourceFilteringMethod - Wählen Sie Computer nach aus.
string. Zulässige Werte: machineNames (Computernamen), tags. Standardwert. machineNames.

MachineNames - Filterkriterien
string.

Diese Eingabe ist nur für Computergruppen gültig und wird für eine flache Liste von Computern oder Ausgabevariablen noch nicht unterstützt.

Gibt eine durch Trennzeichen getrennte Liste von Computern an, z dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34. B. , oder Tags wie Role:DB; OS:Win8.1. Wenn mehrere Tags bereitgestellt werden, wird der Task auf allen Computern mit den angegebenen Tags ausgeführt. Standardmäßig wird die Aufgabe auf allen Computern ausgeführt.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.104.0 oder höher
Aufgabenkategorie	Bereitstellen

Freigeben über