AzureFileCopy@1 - Azure 檔案複製 v1 工作

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

注意

這項工作不支援使用工作流程身分識別同盟進行 Azure Resource Manager驗證。

Syntax

# Azure file copy v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  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. 
    #AdditionalArguments: # string. Additional Arguments. 
    #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 。

注意：標籤的有效分隔符號包括 、 (逗號) 、： (冒號) 和 ; (分號) 。 提供多個標記時，工作只會在包含指定標籤的 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 。

AdditionalArguments - 其他引數
string.

提供上傳至 Blob 或 VM 時將套用的其他引數 AzCopy.exe ， /NC:10 例如 。

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

啟用時，請使用自我簽署憑證，在埠 5986 上設定 Windows 遠端系統管理 (WinRM) 接聽程式，而不是 HTTPS 通訊協定。 在 Azure VM 上執行複製作業的必要專案。 如果目標 VM 使用負載平衡器，請針對目標埠設定輸入 NAT 規則， (5986) 。 僅適用于 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 時才有效。

工作控制選項

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

輸出變數

無。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
執行于	Agent、DeploymentGroup
要求	自我裝載代理程式必須具備符合下列需求的功能，才能執行使用此工作的作業：azureps
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	1.103.0 或更新版本
工作類別	部署