WindowsMachineFileCopy@2 – úloha kopírování souborů na počítači s Windows v2

Článek
07/02/2024

Pomocí této úlohy můžete kopírovat soubory do vzdálených počítačů s Windows.

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.

Vstupy

SourcePath - Zdroj
string. Povinná hodnota.

Cesta k souborům, které chcete zkopírovat. Určuje absolutní cestu ke zdrojové složce nebo souboru na místním počítači nebo sdílené složce UNC, například c:\fabrikamfiber nebo \\fabrikamshare\fabrikamfiber. Můžete použít předdefinované systémové proměnné, například $(Build.Repository.LocalPath) (pracovní složka na počítači agenta), které usnadňují určení umístění artefaktů sestavení v počítači, který je hostitelem agenta automatizace.

MachineNames - Stroje
string. Povinná hodnota.

Určuje čárkami oddělený seznam IP adres počítačů nebo plně kvalifikovaných názvů domén, volitelně včetně čísla portu.
Příklad: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 Můžete také zadat výstupní proměnnou jiných úkolů, například $(variableName), nebo můžete použít název skupiny prostředků Azure.

MachineNames - Stroje
string.

Určuje čárkami oddělený seznam IP adres počítačů nebo plně kvalifikovaných názvů domén, volitelně včetně čísla portu. Příklad: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Můžete také zadat výstupní proměnnou jiných úkolů, například $(variableName), nebo můžete použít název skupiny prostředků Azure.

AdminUserName - přihlášení Správa
string. Povinná hodnota.

Určuje uživatelské jméno domény nebo účtu místního správce na cílových hostitelích. Podporují se formáty jako doména\uživatelské_jméno, uživatelské jméno a název_počítače\uživatelské_jméno . Formáty hlavního názvu uživatele (UPN), jako username@domain.comje , a předdefinované systémové účty, například NT Authority\System, nejsou podporovány.

AdminUserName - přihlášení Správa
string.

AdminPassword - Heslo
string. Povinná hodnota.

Určuje heslo pro přihlášení správce pro cílové počítače. Proměnné definované v kanálech sestavení nebo verze, jako $(passwordVariable)je , se přijímají. Proměnnou můžete označit jako secret zabezpečenou.

AdminPassword - Heslo
string.

TargetPath - Cílová složka
string. Povinná hodnota.

Určuje místní cestu na cílových počítačích nebo přístupnou cestu UNC pro kopírování souborů ze zdroje, například d:\fabrikam nebo \\fabrikam\Web.

CleanTargetBeforeCopy - Čistý cíl
boolean. Výchozí hodnota: false.

Odstraní všechny soubory v cílové složce před zkopírováním nových souborů do ní.

CopyFilesInParallel - Paralelní kopírování souborů
boolean. Výchozí hodnota: true.

Zkopíruje soubory do všech cílových počítačů paralelně, což může urychlit proces kopírování.

AdditionalArguments - Další argumenty
string.

Určuje další argumenty Nástroje RoboCopy, které se použijí při kopírování souborů, například /min:33553332 /l.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tato úloha slouží ke kopírování souborů aplikace a dalších artefaktů, jako jsou skripty PowerShellu a moduly PowerShell-DSC, které jsou potřeba k instalaci aplikace na počítače s Windows. Používá RoboCopy, nástroj příkazového řádku vytvořený pro rychlé kopírování dat.

Proč se při použití této úlohy zobrazuje systémová chyba 53?

Obvykle k tomu dochází v případě, že zadanou cestu nelze najít. Příčinou může být blokování portů potřebných pro sdílení souborů a tiskáren bránou firewall nebo neplatná specifikace cesty. Další podrobnosti najdete v tématu Chyba 53 na Webu TechNet.

Novinky ve verzi 2.0

Přidává se podpora proxy serveru.
Odebrali jsme podporu starších počítačů DTL.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.104.0 nebo vyšší
Kategorie úloh	Nasazení

Sdílet prostřednictvím