使用此工作將檔案複製到遠端 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\username、 username 和 machine-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 或更新 |
| 工作類別 | 部署 |