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 的逗號分隔清單，選擇性地包含埠號碼。
例如： 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. 必要。

指定目標主機上網域或本機系統管理帳戶的使用者名稱， (s) 。 支援網域\使用者名稱、使用者名稱和電腦名稱稱\username等格式。 不支援 UPN 格式，例如 username@domain.com 、 和內建的系統帳戶，例如 NT Authority\System。


AdminUserName - 管理員登入
string.

指定目標主機上網域或本機系統管理帳戶的使用者名稱， (s) 。 支援網域\使用者名稱、使用者名稱和電腦名稱稱\username等格式。 不支援 UPN 格式，例如 username@domain.com 、 和內建的系統帳戶，例如 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 。


工作控制項選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

無。

備註

使用此工作來複製應用程式檔和其他成品，例如 PowerShell 腳本和 PowerShell-DSC 模組，這是在 Windows 機器上安裝應用程式的必要專案。 它會使用 RoboCopy，這是專為快速複製資料而建置的命令列公用程式。

為何在使用這項工作時收到系統錯誤 53？

通常當指定的路徑無法找到時，就會發生這種情況。 這可能是因為防火牆封鎖了檔案和印表機共用的必要端口，或路徑規格無效。 如需詳細資訊，請參閱 TechNet 上的 錯誤 53 。

2.0 版的新功能

  • 正在新增 Proxy 支援。
  • 已移除舊版 DTL 機器的支援。

規格需求

需求 描述
管線類型 YAML、傳統組建、傳統版本
在 上執行 Agent、DeploymentGroup
要求 無
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任意
可設定變數 任意
代理程式版本 1.104.0 或更新版本
工作類別 部署