AzureFileCopy@5 - Azure 檔案複製 v5 工作

將檔案複製到 Azure Blob 儲存體 或虛擬機。

# Azure file copy v5
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@5
  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). 
    #sasTokenTimeOutInMinutes: '240' # string. Optional. Use when Destination = AzureBlob. SAS Token Expiration Period In Minutes. Default: 240.
    #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. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.

SourcePath - 源
string. 必要。

來源檔案的位置。 支援的值包括 YAML 管線和傳統版本支援 預先定義的系統變數 ，例如 Build.Repository.LocalPath。

只有傳統版本才支持發行變數。 檔案路徑或檔名中的任何位置都支援通配符符號 (*) 。

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

指定針對目標 Azure 服務、虛擬機或記憶體帳戶所在訂用帳戶所設定的 Azure Resource Manager 服務連線名稱。 如需詳細資訊，請參閱 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。

指定 Azure Blob 容器內目的地虛擬目錄的前置詞。 這 SourcePath 適用於 包含可能符合多個專案的通配符時。

範例：您可以附加組建編號，以將所有 Blob 中的檔案加上相同的組建編號。

範例：如果您指定 Blob 前置詞 myvd1，則會在容器內建立虛擬目錄。 檔案會從來源 https://myaccount.blob.core.windows.net/mycontainer/myvd1/複製到 。

如果 SourcePath 是沒有通配符的單一專案，此 Blob 前置詞會作為目的地 Blob 名稱。

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

vmsAdminUserName - 管理員 登入
string. 當 Destination = AzureVMs 時為必要。

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

• 支援的格式包括： username、 domain\username、 machine-name\username、 與 .\username。
• 不支援包含和內建系統帳戶等 NT Authority\System UPN格式username@domain.com。

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

提供 參數的密碼 Admin Login 。

若要尋找變數，請找出 Admin Login 參數。 選取索引標籤中 Variables 定義之變數的掛鎖圖示，以保護值，並在此處插入變數名稱。

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

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

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

AdditionalArgumentsForBlobCopy - 將檔案上傳至 Blob) 的選擇性自變數 (
string.

提供其他自變數以供 AzCopy.exe 上傳至 Blob 並下載至 VM 時使用。 如需詳細資訊 ，請參閱使用 AzCopy Command-Line 公用程式傳輸數據 。

針對僅支援 Azure 分頁 Blob 的進階記憶體帳戶，請使用 --blob-type=PageBlob 作為其他自變數。

默認自變數包括 --log-level=INFO (預設) ，如果 --recursive 容器名稱未 $root) ，則 (。

AdditionalArgumentsForVMCopy - 將檔案下載至 VM) 的選擇性自變數 (
string. 選擇性。 使用 時 Destination = AzureVMs。

提供下載至 VM 時將套用的其他自變數 AzCopy.exe ， --check-length=true例如 。

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

• --log-level=INFO
• --log-level=DEBUG (如果管線是在偵錯模式設定中執行，)
• --recursive

sasTokenTimeOutInMinutes - SAS 令牌到期期間以分鐘為單位
string. 選擇性。 使用 時 Destination = AzureBlob。 預設值：240。

指定容器 SAS 令牌到期的分鐘數。 根據預設，此令牌會在 4 小時後到期。

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

啟用時，此選項會使用自我簽署憑證，透過埠 5986 上的 HTTPS 通訊協定，設定 Windows 遠端管理 (WinRM) 接聽程式。 在 Azure VM 上執行複製作業需要此設定。 僅適用於 ARM VM。

• 如果目標 VM 是透過負載平衡器存取，請設定輸入 NAT 規則以允許在埠 5986 上存取。
• 如果目標 VM 與網路安全組 (NSG) 相關聯，請設定輸入安全性規則以允許在埠 5986 上存取。

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

指定 true 以平行方式將檔案複製到目標 VM。

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

指定 true 複製檔案之前清除目的地資料夾。

skipCACheck - 測試憑證
boolean. 選擇性。 使用時機 Destination = AzureVMs。 預設值：true。

將檔案從中繼記憶體 Blob 複製到 Azure VM 時，WinRM 需要 HTTPS 傳輸的憑證。

如果您使用自我簽署憑證，請指定 true 來防止程式使用受信任的 CA 驗證憑證。

此工作會定義下列 輸出變數，您可以在下游步驟、作業和階段中取用這些變數。

StorageContainerUri
檔案複製到其中的容器 URI。 只有在選取的目的地是 Azure Blob 時才有效。

StorageContainerSasToken
檔案複製到其中的容器 SasToken。 只有在選取的目的地是 Azure Blob 時才有效。