AzureFileCopy@3 - Azure 檔案複製 v3 工作

將檔案複製到 Azure Blob 記憶體或虛擬機。

此工作已被取代，因為此版本的 AzureFileCopy 工作使用的是已停用的 AzCopy 版本。 使用最新版的 AzureFileCopy 工作。 請參閱 AzCopy 移轉指南，以瞭解 v8 至 v10。

將檔案複製到 Azure Blob 記憶體或虛擬機。

# Azure file copy v3
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@3
  inputs:
    SourcePath: # string. Required. Source. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    storage: # string. Alias: StorageAccountRM. Required. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when 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 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. 
    #sasTokenTimeOutInMinutes: # string. SAS Token Expiration Period In Minutes.

SourcePath - 來源
string。 必須的。

指定源資料夾的絕對路徑，或本機計算機上的檔案，或 UNC 共用。 您可以使用預先定義的系統變數，例如 $(Build.Repository.LocalPath)。 不支援包含通配符的名稱，例如 *.zip。 您指定的值或表示式應該會傳回單一資料夾或檔案名。

azureSubscription - Azure 訂用帳戶
輸入別名： ConnectedServiceNameARM。 string。 必須的。

指定 Azure Resource Manager 服務連線的名稱， 針對目標 Azure 服務、虛擬機或記憶體帳戶所在的訂用帳戶進行設定。 如需詳細資訊，請參閱 Azure Resource Manager 概觀。

Destination - 目的地類型
string。 必須的。 允許的值：AzureBlob（Azure Blob）、AzureVMs（Azure VM）。

指定目的地類型。

storage - RM 記憶體帳戶
輸入別名： StorageAccountRM。 string。 必須的。

指定預先存在的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/。

resourceGroup - 資源群組
輸入別名： EnvironmentNameRM。 string。 Destination = AzureVMs時為必要項。

指定將複製檔案的目標資源群組名稱。

ResourceFilteringMethod - 依 選取機器
string。 選擇性。 Destination = AzureVMs時使用 。 允許的值：machineNames （機器名稱），tags。 預設值：machineNames。

指定 VM 主機名稱或標記，以識別資源群組中的 VM 子集。 標籤 僅支援透過 Azure Resource Manager 建立的資源。

MachineNames - 篩選準則
string。 選擇性。 Destination = AzureVMs時使用 。

提供 VM 名稱或標籤名稱的清單，以識別工作的目標 VM。 有效的篩選準則包括：

• Azure 資源群組的名稱。
• 上一個工作的輸出變數。
• 以逗號分隔的標籤名稱或 VM 名稱清單。
• 使用以逗號分隔的 FQDN 或 IP 位址清單格式化 VM 名稱。
• 將篩選的標籤名稱格式化為 {TagName}:{Value}。 範例：Role:DB;OS:Win8.1、ffweb、ffdb或標籤，例如 Role:DB、Web、OS:Win8.1。

注意：卷標的有效分隔符包括 、（逗號）、:(號）和 ;(semicolon）。 提供多個標記時，工作只會在包含指定標籤的 VM 中執行。 根據預設，工作會在所有 VM 中執行。

vmsAdminUserName - 系統管理員登入
string。 Destination = AzureVMs時為必要項。

為所有目標 VM 提供具有系統管理許可權的帳戶用戶名稱。

• 支援的格式包括：username、domain\username、machine-name\username和 .\username。
• 不支援 UPN 格式，包括 [email protected] 和內建系統帳戶，例如 NT Authority\System。

vmsAdminPassword - 密碼
string。 Destination = AzureVMs時為必要項。

提供 VM 的系統管理員密碼。

有效的輸入包含建置或發行管線中定義的變數，例如 $(passwordVariable)。 若要保護密碼，請將密碼標示為 secret。

TargetPath - 目的地資料夾
string。 Destination = AzureVMs時為必要項。

指定將複製檔案之 Azure VM 中資料夾的路徑。

支援 $env:windir 和 $env:systemroot 等環境變數。 範例：$env:windir\FabrikamFiber\Web 和 c:\FabrikamFiber

AdditionalArgumentsForBlobCopy - 選擇性自變數
string。

提供其他自變數給上傳至 Blob 時可套用的 AzCopy.exe，例如 /NC:10。

如果未指定選擇性自變數，預設會新增下列自變數。

• /Y
• /SetContentType
• /Z
• /V
• /S - 當容器名稱未 $root時新增。
• 當指定的記憶體帳戶是進階帳戶時，/BlobType:page -Added。
• /Pattern - 當來源路徑為檔案時新增。 隨附於任何其他指定的選擇性自變數。

AdditionalArgumentsForVMCopy - 選擇性自變數 （用於將檔案下載至 VM）
string。 選擇性。 Destination = AzureVMs時使用 。

將其他自變數提供給 AzCopy.exe，這些自變數可在下載至 vm 時套用，例如 /NC:10。

如果未指定選擇性自變數，預設會新增下列專案。

• /Y
• /S
• /Z
• /V

enableCopyPrerequisites - 啟用複製必要條件
boolean。 選擇性。 Destination = AzureVMs時使用 。 預設值：false。

啟用時，使用自我簽署憑證在埠 5986 上設定 Windows 遠端管理 （WinRM） 接聽程式，而不是 HTTPS 通訊協定。 在 Azure VM 上執行複製作業的必要專案。 如果目標 VM 使用負載平衡器，請設定目標埠 （5986） 的輸入 NAT 規則。 僅適用於 ARM VM。 在與網路安全組相關聯的目標 VM 上，設定輸入安全性規則以允許在埠 5986 上存取。

平行複製 CopyFilesInParallel -
boolean。 選擇性。 Destination = AzureVMs時使用 。 預設值：true。

指定 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 令牌所使用的變數名稱，以存取已複製的檔案。 使用此變數做為後續工作的輸入。 根據預設，SAS 令牌會在 4 小時後到期。

sasTokenTimeOutInMinutes - SAS 令牌到期期間，以分鐘為單位
string。

指定SAS令牌到期的分鐘數。 只有在選取的目的地是 Azure Blob 時才有效。

沒有。