共用方式為


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.

輸入

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 資源組的名稱。


AdminUserName - 系統管理員登入
string。 必須的。

指定目標主機上網域或本機系統管理帳戶的用戶名稱。 支援 domain\usernameusernamemachine-name\username 等格式。 不支援UPN格式(如 username@domain.com)和內置系統帳戶(如 NT Authority\System)。


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、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
要求 沒有
能力 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 1.104.0 或更新
工作類別 部署