AzureFileCopy@2 - Azure 檔案複製 v2 工作
將檔案複製到 Azure Blob 記憶體或虛擬機。
此工作已被取代，因為此版本的 AzureFileCopy 工作使用的是已停用的 AzCopy 版本。 使用最新版的 AzureFileCopy 工作。 請參閱 AzCopy 移轉指南，以瞭解 v8 至 v10。
語法
# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
inputs:
SourcePath: # string. Required. Source.
#azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
#azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription.
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription.
Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type.
#classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account.
storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account.
#ContainerName: # string. Required when Destination = AzureBlob. Container Name.
#BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix.
#cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service.
#resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
#MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria.
#vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login.
#vmsAdminPassword: # string. Required when Destination = AzureVMs. Password.
#TargetPath: # string. Required when Destination = AzureVMs. Destination Folder.
#AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob).
#AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM).
#enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
#CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
#CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
#skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
# Output
#outputStorageUri: # string. Storage Container URI.
#outputStorageContainerSasToken: # string. Storage Container SAS Token.
輸入
SourcePath
-
來源
string。 必須的。
指定源資料夾、本機電腦上檔案或 UNC 共用的絕對路徑。 指定的值或表示式應該傳回單一資料夾名稱或檔名。
azureConnectionType
-
Azure 連線類型
輸入別名：ConnectedServiceNameSelector。
string。 允許的值：ConnectedServiceName（Azure 傳統版）、ConnectedServiceNameARM （Azure Resource Manager）。 預設值：ConnectedServiceNameARM。
指定 Azure 連線類型。
azureClassicSubscription
-
Azure 傳統訂用帳戶
輸入別名：ConnectedServiceName。
string。
ConnectedServiceNameSelector = ConnectedServiceName時為必要項。
指定目標 Azure 傳統訂用帳戶。
azureSubscription
-
Azure 訂用帳戶
輸入別名：ConnectedServiceNameARM。
string。
ConnectedServiceNameSelector = ConnectedServiceNameARM時為必要項。
指定目標 Azure Resource Manager 訂用帳戶。
Destination
-
目的地類型
string。 必須的。 允許的值：AzureBlob（Azure Blob）、AzureVMs（Azure VM）。
指定要用於複製檔案的目的地類型。
classicStorage
-
傳統記憶體帳戶
輸入別名：StorageAccount。
string。
ConnectedServiceNameSelector = ConnectedServiceName時為必要項。
指定預先存在的傳統記憶體帳戶。 這是作為將檔案複製到 Azure VM 的媒介使用的記憶體帳戶。
storage
-
RM 記憶體帳戶
輸入別名：StorageAccountRM。
string。
ConnectedServiceNameSelector = ConnectedServiceNameARM時為必要項。
指定預先存在的ARM記憶體帳戶。 這是作為將檔案複製到 Azure VM 的媒介使用的記憶體帳戶。
ContainerName
-
容器名稱
string。
Destination = AzureBlob時為必要項。
指定複製檔案的容器名稱。 如果指定的容器不存在於記憶體帳戶中，則會建立它。
若要在容器內建立虛擬目錄，請使用 Blob 前置詞輸入。 例如，針對目標位置 https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/，請指定容器名稱 mycontainer 和 Blob 前置詞 vd1/vd2。
BlobPrefix
-
Blob 前置詞
string。 選擇性。
Destination = AzureBlob時使用 。
指定可用來篩選檔案的前置詞。
範例：您可以附加組建編號，以篩選所有具有相同組建編號的 Blob 檔案。
範例：如果您指定 Blob 前置詞 myvd1，則會在容器內建立虛擬目錄。 檔案會從來源複製到 https://myaccount.blob.core.windows.net/mycontainer/myvd1/。
cloudService
-
雲端服務
輸入別名：EnvironmentName。
string。
ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs時為必要項。
指定目標雲端服務的名稱。
resourceGroup
-
資源群組
輸入別名：EnvironmentNameRM。
string。
ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs時為必要項。
指定目標資源群組的名稱。
ResourceFilteringMethod
-
依 選取機器
string。 選擇性。
Destination = AzureVMs時使用 。 允許的值：machineNames （機器名稱），tags。 預設值：machineNames。
指定 VM 主機名稱或標記，以識別資源群組中的 VM 子集。 標籤 僅支援透過 Azure Resource Manager 建立的資源。
MachineNames
-
篩選準則
string。 選擇性。
Destination = AzureVMs時使用 。
提供 Azure VM 主機名清單，例如 ffweb、ffdb或標籤，例如 Role:DB、Web、OS:Win8.1。
注意：卷標的有效分隔符包括 、（逗號）、:(號）和 ;(semicolon）。 提供多個標記時，工作將會在包含指定標籤的所有 VM 中執行。 根據預設，工作會在所有 VM 中執行。
vmsAdminUserName
-
系統管理員登入
string。
Destination = AzureVMs時為必要項。
提供 Azure VM 系統管理員帳戶的用戶名稱。
vmsAdminPassword
-
密碼
string。
Destination = AzureVMs時為必要項。
提供 Azure VM 系統管理員帳戶的密碼。
有效的輸入包含建置或發行管線中定義的變數，例如 $(passwordVariable)。 若要保護密碼，請將密碼標示為 secret。
TargetPath
-
目的地資料夾
string。
Destination = AzureVMs時為必要項。
指定目標 VM 上的本機路徑。
有效的輸入包含環境變數，例如 $env:windir\BudgetIT\Web。
AdditionalArgumentsForBlobCopy
-
選擇性自變數
string。
提供其他自變數給上傳至 Blob 時可套用的 AzCopy.exe，例如 /NC:10。
如果未指定選擇性自變數，預設會新增下列自變數。
/Y/SetContentType/Z/V-
/S- 當容器名稱未$root時新增。 -
/BlobType:page- 當指定的記憶體帳戶是進階帳戶時新增。 -
/Pattern- 當來源路徑為檔案時新增。 隨附於任何其他指定的選擇性自變數。
AdditionalArgumentsForVMCopy
-
選擇性自變數 （用於將檔案下載至 VM）
string。 選擇性。
Destination = AzureVMs時使用 。
將其他自變數提供給 AzCopy.exe，這些自變數可在下載至 vm 時套用，例如 /NC:10。
如果未指定選擇性自變數，預設會新增下列專案。
/Y/S/Z/V
enableCopyPrerequisites
-
啟用複製必要條件
boolean。 選擇性。
ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs時使用 。 預設值：false。
啟用時，使用自我簽署憑證在埠 5986 上設定 Windows 遠端管理 （WinRM） 接聽程式，而不是 HTTPS 通訊協定。 在 Azure VM 上執行複製作業的必要專案。 如果目標 VM 使用負載平衡器，請設定目標埠 （5986） 的輸入 NAT 規則。 僅適用於 ARM VM。
平行複製 CopyFilesInParallel -
boolean。 選擇性。
Destination = AzureVMs時使用 。 預設值：true。
接受預設設定會將檔案平行複製到目標 VM。
CleanTargetBeforeCopy
-
清除目標
boolean。 選擇性。
Destination = AzureVMs時使用 。 預設值：false。
將此值設定為 true 會先清除目的地資料夾，再執行複製動作。
skipCACheck
-
測試憑證
boolean。 選擇性。
Destination = AzureVMs時使用 。 預設值：true。
在透過 HTTPS 連線之前，預設值不會驗證伺服器證書是否已由受信任的 CA 簽署。
outputStorageUri
-
記憶體容器 URI
string。
指定用於複製檔案之記憶體容器 URI 的變數名稱。 只有在選取的目的地是 Azure Blob 時才有效。
outputStorageContainerSasToken
-
記憶體容器 SAS 令牌
string。
指定記憶體容器 SAS 令牌所使用的變數名稱，以存取已複製的檔案。 只有在選取的目的地是 Azure Blob 時才有效。
工作控制選項
除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。
輸出變數
沒有。
備註
2.0 版的新功能：使用較新版本的 AzCopy。