WindowsMachineFileCopy@2 – Windows rendszerű gép fájlmásolási v2-feladata

Cikk
07/02/2024

Ezzel a feladatsal fájlokat másolhat távoli Windows-gépekre.

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.

Bevitelek

SourcePath - Forrás
string. Kötelező.

A másolandó fájlok elérési útja. Megadja a forrásmappa vagy -fájl abszolút elérési útját a helyi gépen vagy egy UNC-megosztáson, például c:\fabrikamfiber vagy \\fabrikamshare\fabrikamfiber. Használhat előre definiált rendszerváltozókat, például $(Build.Repository.LocalPath) (az ügynökszámítógép munkamappáját), így egyszerűen megadhatja az automation-ügynököt futtató számítógépen a buildösszetevők helyét.

MachineNames - Gépek
string. Kötelező.

A gép IP-címeinek vagy teljes tartományneveinek vesszővel tagolt listáját adja meg, opcionálisan a portszámmal együtt.
Például: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 Megadhatja más tevékenységek kimeneti változóját is, például $(variableName), vagy használhatja egy Azure-erőforráscsoport nevét.

MachineNames - Gépek
string.

A gép IP-címeinek vagy teljes tartományneveinek vesszővel tagolt listáját adja meg, opcionálisan a portszámmal együtt. Példa: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Megadhatja más tevékenységek kimeneti változóját is, például $(variableName), vagy használhatja egy Azure-erőforráscsoport nevét.

AdminUserName - Rendszergazda bejelentkezés
string. Kötelező.

Megadja egy tartomány vagy egy helyi rendszergazdai fiók felhasználónevét a cél gazdagép(ek)en. Az olyan formátumok, mint a tartomány\felhasználónév, felhasználónév és gépnév\felhasználónév támogatottak. Az UPN-formátumok, például username@domain.coma , és a beépített rendszerfiókok, például az NT Authority\System nem támogatottak.

AdminUserName - Rendszergazda bejelentkezés
string.

AdminPassword - Jelszó
string. Kötelező.

Megadja a célgépek rendszergazdai bejelentkezésének jelszavát. A buildelési vagy kiadási folyamatokban definiált változók (például $(passwordVariable)) elfogadottak. A változót biztonságosként secret jelölheti meg.

AdminPassword - Jelszó
string.

TargetPath - Célmappát
string. Kötelező.

Megadja a célgépek helyi elérési útját vagy egy akadálymentes UNC elérési utat a fájlok forrásból történő másolásához, például d:\fabrikam vagy \\fabrikam\Web.

CleanTargetBeforeCopy - Tiszta cél
boolean. Alapértelmezett érték: false.

Az új fájlok másolása előtt törli a célmappában lévő összes fájlt.

CopyFilesInParallel - Fájlok párhuzamos másolása
boolean. Alapértelmezett érték: true.

A fájlokat az összes célgépre párhuzamosan másolja, ami felgyorsíthatja a másolási folyamatot.

AdditionalArguments - További argumentumok
string.

A fájlok másolásakor alkalmazott további RoboCopy-argumentumokat adja meg, például /min:33553332 /l: .

Tevékenységvezérlési beállítások

A tevékenységbemeneteken kívül minden tevékenység rendelkezik vezérlési lehetőségekkel. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladatmal alkalmazásfájlokat és egyéb összetevőket másolhat, például PowerShell-szkripteket és PowerShell-DSC-modulokat, amelyek az alkalmazás Windows rendszerű gépekre való telepítéséhez szükségesek. A RoboCopyt, az adatok gyors másolására szolgáló parancssori segédprogramot használja.

Miért jelenik meg az 53-at jelző rendszerhiba a feladat használatakor?

Ez általában akkor fordul elő, ha a megadott elérési út nem található. Ennek az lehet az oka, hogy egy tűzfal blokkolja a fájl- és nyomtatómegosztáshoz szükséges portokat, vagy érvénytelen elérésiút-specifikáció van érvényben. További részletekért lásd: 53-os hiba a TechNeten.

A 2.0-s verzió újdonságai

A proxytámogatás hozzáadása folyamatban van.
Az örökölt DTL-gépek támogatása megszűnt.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.104.0 vagy újabb
Feladatkategória	Üzembe helyezés

Megosztás a következőn keresztül: