WindowsMachineFileCopy@2 - Windows 컴퓨터 파일 복사 v2 작업
이 작업을 사용하여 원격 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.
입력
SourcePath
- 소스
string
. 필수 요소.
복사할 파일의 경로입니다. 로컬 컴퓨터 또는 UNC 공유(예 c:\fabrikamfiber
: 또는 \\fabrikamshare\fabrikamfiber
)에 있는 원본 폴더 또는 파일의 절대 경로를 지정합니다. (에이전트 컴퓨터의 작업 폴더)와 같이 $(Build.Repository.LocalPath)
미리 정의된 시스템 변수를 사용하면 자동화 에이전트를 호스트하는 컴퓨터에서 빌드 아티팩트 위치를 쉽게 지정할 수 있습니다.
MachineNames
- 기계
string
. 필수 요소.
선택적으로 포트 번호를 포함하여 컴퓨터 IP 주소 또는 FQDN의 쉼표로 구분된 목록을 지정합니다.
예를 들어 다른 작업의 출력 변수(예$(variableName)
: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34
)를 지정하거나 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
.
와 같이 /min:33553332 /l
파일을 복사할 때 적용되는 추가 RoboCopy 인수를 지정합니다.
작업 제어 옵션
모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.
출력 변수
없음
설명
이 작업을 사용하여 Windows 컴퓨터에 애플리케이션을 설치하는 데 필요한 PowerShell 스크립트 및 PowerShell-DSC 모듈과 같은 애플리케이션 파일 및 기타 아티팩트도 복사할 수 있습니다. 데이터의 빠른 복사를 위해 빌드된 명령줄 유틸리티인 RoboCopy를 사용합니다.
이 작업을 사용할 때 시스템 오류 53이 발생하는 이유는 무엇인가요?
일반적으로 지정된 경로를 찾을 수 없는 경우에 발생합니다. 이는 파일 및 프린터 공유에 필요한 포트를 차단하는 방화벽 또는 잘못된 경로 사양 때문일 수 있습니다. 자세한 내용은 TechNet 의 오류 53 을 참조하세요.
버전 2.0의 새로운 기능
- 프록시 지원이 추가되고 있습니다.
- 레거시 DTL 머신의 지원이 제거되었습니다.
요구 사항
요구 사항 | Description |
---|---|
파이프라인 유형 | YAML, 클래식 빌드, 클래식 릴리스 |
실행 중 | 에이전트, DeploymentGroup |
요청 | 없음 |
Capabilities | 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다. |
명령 제한 사항 | 모두 |
설정 가능한 변수 | 모두 |
에이전트 버전 | 1.104.0 이상 |
작업 범주 | 배포 |