WindowsMachineFileCopy@2 - Windows-computerbestand kopiëren v2-taak

Artikel
07/02/2024

Gebruik deze taak om bestanden te kopiëren naar externe Windows-computers.

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.

Invoerwaarden

SourcePath - Bron
string. Vereist.

Het pad naar de bestanden die u wilt kopiëren. Hiermee geeft u het absolute pad op van de bronmap of het bronbestand op de lokale computer of een UNC-share, zoals c:\fabrikamfiber of \\fabrikamshare\fabrikamfiber. U kunt vooraf gedefinieerde systeemvariabelen gebruiken, zoals $(Build.Repository.LocalPath) (de werkmap op de agentcomputer), waarmee u eenvoudig de locatie van de buildartefacten kunt opgeven op de computer waarop de automatiseringsagent wordt gehost.

MachineNames - Machines
string. Vereist.

Hiermee geeft u een door komma's gescheiden lijst met IP-adressen of FQDN's van de machine op, optioneel inclusief het poortnummer.
Bijvoorbeeld: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 u kunt ook de uitvoervariabele van andere taken opgeven, bijvoorbeeld $(variableName), of u kunt de naam van een Azure-resourcegroep gebruiken.

MachineNames - Machines
string.

Hiermee geeft u een door komma's gescheiden lijst met IP-adressen of FQDN's van de machine op, optioneel inclusief het poortnummer. Bijvoorbeeld: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. U kunt ook de uitvoervariabele van andere taken opgeven, bijvoorbeeld $(variableName), of u kunt de naam van een Azure-resourcegroep gebruiken.

AdminUserName - Beheer aanmelden
string. Vereist.

Hiermee geeft u de gebruikersnaam van een domein of een lokaal beheerdersaccount op de doelhost(s). Indelingen zoals domein\gebruikersnaam, gebruikersnaam en computernaam\gebruikersnaam worden ondersteund. UPN-indelingen, zoals username@domain.com, en ingebouwde systeemaccounts, zoals NT Authority\System, worden niet ondersteund.

AdminUserName - Beheer aanmelden
string.

AdminPassword - Wachtwoord
string. Vereist.

Hiermee geeft u het wachtwoord voor de beheerdersaanmelding voor de doelcomputers. Variabelen die zijn gedefinieerd in build- of release-pijplijnen, zoals $(passwordVariable), worden geaccepteerd. U kunt de variabele markeren als secret om deze te beveiligen.

AdminPassword - Wachtwoord
string.

TargetPath - Doelmap
string. Vereist.

Hiermee geeft u het lokale pad op de doelcomputers of een toegankelijk UNC-pad op voor het kopiëren van de bestanden uit de bron, zoals d:\fabrikam of \\fabrikam\Web.

CleanTargetBeforeCopy - Doel opschonen
boolean. Standaardwaarde: false.

Hiermee verwijdert u alle bestanden in de doelmap voordat u de nieuwe bestanden naar de map kopieert.

CopyFilesInParallel - Bestanden parallel kopiëren
boolean. Standaardwaarde: true.

Bestanden parallel naar alle doelcomputers worden gekopieerd, waardoor het kopieerproces kan worden versneld.

AdditionalArguments - Aanvullende argumenten
string.

Hiermee geeft u aanvullende RoboCopy-argumenten op die worden toegepast bij het kopiëren van bestanden, zoals /min:33553332 /l.

Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om toepassingsbestanden en andere artefacten, zoals PowerShell-scripts en PowerShell-DSC-modules, te kopiëren die nodig zijn om de toepassing op Windows-computers te installeren. Het maakt gebruik van RoboCopy, het opdrachtregelprogramma dat is gebouwd voor het snel kopiëren van gegevens.

Waarom krijg ik een systeemfout 53 bij het gebruik van deze taak?

Dit gebeurt meestal wanneer het opgegeven pad niet kan worden gevonden. Dit kan worden veroorzaakt door een firewall die de benodigde poorten voor het delen van bestanden en printers blokkeert of een ongeldige padspecificatie. Zie Fout 53 op TechNet voor meer informatie.

Wat is er nieuw in versie 2.0

Proxyondersteuning wordt toegevoegd.
Ondersteuning van verouderde DTL-machines verwijderd.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.104.0 of hoger
Taakcategorie	Implementeren

Delen via