이 작업을 사용하여 원격 Windows 컴퓨터에 파일을 복사합니다.
문법
# 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.
입력
SourcePath
-
원본
string
; 필수 사항입니다.
복사할 파일의 경로입니다. 로컬 컴퓨터 또는 UNC 공유(예: c:\fabrikamfiber
또는 \\fabrikamshare\fabrikamfiber
)에 있는 원본 폴더 또는 파일의 절대 경로를 지정합니다. (에이전트 컴퓨터의 작업 폴더)와 같은 $(Build.Repository.LocalPath)
미리 정의된 시스템 변수를 사용할 수 있으며, 이를 통해 자동화 에이전트를 호스팅하는 컴퓨터에서 빌드 아티팩트의 위치를 쉽게 지정할 수 있습니다.
MachineNames
-
기계
string
; 필수 사항입니다.
쉼표로 구분된 컴퓨터 IP 주소 또는 FQDN 목록을 지정하며, 필요에 따라 포트 번호를 포함합니다.
예를 dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34
들어 다른 작업의 $(variableName)
출력 변수를 지정하거나 Azure 리소스 그룹의 이름을 사용할 수도 있습니다.
MachineNames
-
기계
string
;
쉼표로 구분된 컴퓨터 IP 주소 또는 FQDN 목록을 지정하며, 필요에 따라 포트 번호를 포함합니다. 예: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34
. 다른 작업의 출력 변수(예: $(variableName)
)를 지정하거나 Azure 리소스 그룹의 이름을 사용할 수도 있습니다.
AdminUserName
-
관리자 로그인
string
; 필수 사항입니다.
대상 호스트의 도메인 또는 로컬 관리 계정의 사용자 이름을 지정합니다.
___domain\username, username 및 machine-name\username과 같은 형식이 지원됩니다. 와 같은 username@___domain.com
UPN 형식 및 NT Authority\System과 같은 기본 제공 시스템 계정은 지원되지 않습니다.
AdminUserName
-
관리자 로그인
string
;
대상 호스트의 도메인 또는 로컬 관리 계정의 사용자 이름을 지정합니다.
___domain\username, username 및 machine-name\username과 같은 형식이 지원됩니다. 와 같은 username@___domain.com
UPN 형식 및 NT Authority\System과 같은 기본 제공 시스템 계정은 지원되지 않습니다.
AdminPassword
-
암호
string
; 필수 사항입니다.
대상 컴퓨터의 관리자 로그인 암호를 지정합니다. 빌드 또는 릴리스 파이프라인에 정의된 변수(예: $(passwordVariable)
)가 허용됩니다. 변수를 secret
보안으로 표시할 수 있습니다.
AdminPassword
-
암호
string
;
대상 컴퓨터의 관리자 로그인 암호를 지정합니다. 빌드 또는 릴리스 파이프라인에 정의된 변수(예: $(passwordVariable)
)가 허용됩니다. 변수를 secret
보안으로 표시할 수 있습니다.
대상 폴더TargetPath
-
string
; 필수 사항입니다.
대상 컴퓨터의 로컬 경로 또는 원본에서 파일을 복사하기 위한 액세스 가능한 UNC 경로(예: d:\fabrikam
또는 \\fabrikam\Web
)를 지정합니다.
대상 정리CleanTargetBeforeCopy
-
boolean
; 기본값은 false
입니다.
새 파일을 복사하기 전에 대상 폴더의 모든 파일을 삭제합니다.
병렬파일 복사 CopyFilesInParallel
-
boolean
; 기본값은 true
입니다.
모든 대상 컴퓨터에 파일을 병렬로 복사하여 복사 프로세스의 속도를 높일 수 있습니다.
추가 인수AdditionalArguments
-
string
;
파일을 복사할 때 적용되는 추가 RoboCopy 인수를 지정합니다(예: /min:33553332 /l
.
작업 제어 옵션
모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.
출력 변수
없음.
비고
이 작업을 사용하여 Windows 컴퓨터에 응용 프로그램을 설치하는 데 필요한 응용 프로그램 파일 및 기타 아티팩트(예: PowerShell 스크립트 및 PowerShell-DSC 모듈)를 복사합니다. 빠른 데이터 복사를 위해 구축된 명령줄 유틸리티인 RoboCopy를 사용합니다.
이 작업을 사용할 때 시스템 오류 53이 발생하는 이유는 무엇입니까?
일반적으로 이 문제는 지정된 경로를 찾을 수 없을 때 발생합니다. 이는 방화벽이 파일 및 프린터 공유에 필요한 포트를 차단하거나 잘못된 경로 사양 때문일 수 있습니다. 자세한 내용은 TechNet의 오류 53 을 참조하십시오.
버전 2.0의 새로운 기능
- 프록시 지원이 추가되고 있습니다.
- 레거시 DTL 머신의 지원이 제거되었습니다.