使用此工作將檔案複製到遠端 Windows 電腦。
語法
# 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.
輸入
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 |
| 需求 | 沒有 |
| 功能 | 此工作不符合作業中後續工作的任何需求。 |
| 命令限制 | 任意 |
| Settable 變數 | 任意 |
| 代理程式版本 | 1.104.0 或更新 |
| 工作類別 | 部署 |