WindowsMachineFileCopy@1 - Windows 計算機檔案複製 v1 工作

發行項
07/02/2024

使用此工作將檔案複製到遠端 Windows 電腦。

Syntax

# Windows machine file copy v1
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

# Windows Machine File Copy v1
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

輸入

SourcePath - 源
string. 必要。

指定本機電腦或 UNC 共用上源資料夾或檔案的絕對路徑，例如 c:\fabrikamfiber 或 \\fabrikamshare\fabrikamfiber。

EnvironmentName - 機器
string.

指定電腦 IP 位址或 FQDN 的逗號分隔清單，例如 dbserver.fabrikam.com,192.168.12.34 您也可以指定其他工作的輸出變數，例如 $(variableName)。

AdminUserName - 管理員登入
string.

指定目標計算機的系統管理員登入。

AdminPassword - 密碼
string.

指定目標計算機的系統管理員登入密碼。接受在組建/發行定義 $(passwordVariable) 中定義的變數。您可以將變數類型標示為 secret 來保護它。

TargetPath - 目的地資料夾
string. 必要。

指定目標電腦上的本機路徑，或可從來源複製檔案的可存取 UNC 路徑，例如 d:\fabrikam 或 \\fabrikam\Web。

CleanTargetBeforeCopy - 清除目標
boolean. 預設值：false。

先清除目的地資料夾，再複製檔案。

CopyFilesInParallel - 平行複製檔案
boolean. 預設值：true。

將檔案平行複製到機器。

AdditionalArguments - 其他自變數
string.

指定複製檔案時套用的其他 robocopy 自變數，例如 /min:33553332 /l。

ResourceFilteringMethod - 選取機器依據
string. 允許的值： machineNames (電腦名稱) ， tags。預設值：machineNames。

MachineNames - 篩選準則
string.

此輸入僅適用於計算機群組，但尚未支援計算機或輸出變數的一般清單。

指定機器的逗號分隔清單，例如 dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34、或標籤，例如 Role:DB; OS:Win8.1。如果提供多個標記，工作將會在所有具有指定標籤的機器中執行。預設會在所有機器中執行工作。

工作控制選項

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

輸出變數

無。

規格需求

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

共用方式為