WindowsMachineFileCopy@2 - Windows 컴퓨터 파일 복사 v2 작업

아티클
04/29/2024

이 작업을 사용하여 원격 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.comUPN 형식 및 NT Authority\System과 같은 기본 제공 시스템 계정은 지원되지 않습니다.

AdminUserName - 관리 로그인
string.

AdminPassword - 암호
string. 필수 요소.

대상 컴퓨터의 관리자 로그인 암호를 지정합니다. 빌드 또는 릴리스 파이프라인(예: $(passwordVariable))에 정의된 변수가 허용됩니다. 변수 secret 를 로 표시하여 보호할 수 있습니다.

AdminPassword - 암호
string.

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 이상
작업 범주	배포