다음을 통해 공유


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

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


AdminUserName - 관리자 로그인
string;

대상 호스트의 도메인 또는 로컬 관리 계정의 사용자 이름을 지정합니다. ___domain\username, usernamemachine-name\username과 같은 형식이 지원됩니다. 와 같은 username@___domain.comUPN 형식 및 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 머신의 지원이 제거되었습니다.

요구 사항

요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 사항 어느 것이든
settable 변수 어느 것이든
에이전트 버전 1.104.0 이상
작업 범주 배치하다