AzureFileCopy@2 - Tugas salinan file Azure v2

Salin file ke Azure Blob Storage atau komputer virtual.

Catatan

Tugas ini tidak mendukung autentikasi Azure Resource Manager dengan federasi identitas alur kerja.

Sintaks

# 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.

Input

SourcePath - Sumber
string. Wajib diisi.

Tentukan jalur absolut ke folder sumber, file pada komputer lokal, atau berbagi UNC. Nilai atau ekspresi yang ditentukan harus mengembalikan nama folder tunggal atau nama file.

azureConnectionType - Jenis Koneksi Azure
Alias input: ConnectedServiceNameSelector. string. Nilai yang diizinkan: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Nilai default: ConnectedServiceNameARM.

Tentukan jenis koneksi Azure.

azureClassicSubscription - Langganan Klasik Azure
Alias input: ConnectedServiceName. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName.

Tentukan langganan Azure Classic target.

azureSubscription - Langganan Azure
Alias input: ConnectedServiceNameARM. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameARM.

Tentukan target langganan Azure Resource Manager.

Destination - Jenis Tujuan
string. Wajib diisi. Nilai yang diizinkan: AzureBlob (Azure Blob), AzureVMs (Azure VM).

Tentukan tipe tujuan yang akan digunakan untuk menyalin file.

classicStorage - Akun Penyimpanan Klasik
Alias input: StorageAccount. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName.

Tentukan akun penyimpanan klasik yang sudah ada sebelumnya. Ini adalah akun penyimpanan yang digunakan sebagai perantara untuk menyalin file ke Azure VM.

storage - Akun Penyimpanan RM
Alias input: StorageAccountRM. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameARM.

Tentukan akun penyimpanan ARM yang sudah ada sebelumnya. Ini adalah akun penyimpanan yang digunakan sebagai perantara untuk menyalin file ke Azure VM.

ContainerName - Nama Kontainer
string. Diperlukan saat Destination = AzureBlob.

Tentukan nama kontainer tempat file disalin. Jika kontainer yang ditentukan tidak ada di akun penyimpanan, kontainer tersebut akan dibuat.

Untuk membuat direktori virtual di dalam kontainer, gunakan input awalan Blob. Misalnya, untuk lokasi https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/target , tentukan nama mycontainer kontainer dan awalan vd1/vd2Blob .

BlobPrefix - Awalan Blob
string. Pilihan. Gunakan saat Destination = AzureBlob.

Tentukan awalan yang dapat digunakan untuk memfilter file.

Contoh: Anda dapat menambahkan nomor build untuk memfilter file dari semua Blob dengan nomor build yang sama.

Contoh: Jika Anda menentukan awalan myvd1Blob, direktori virtual dibuat di dalam kontainer. File disalin dari sumber ke https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - Layanan Cloud
Alias input: EnvironmentName. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Tentukan nama Cloud Service target.

resourceGroup - Grup Sumber Daya
Alias input: EnvironmentNameRM. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Tentukan nama Grup Sumber Daya target.

ResourceFilteringMethod - Pilih Mesin Menurut
string. Opsional. Gunakan saat Destination = AzureVMs. Nilai yang diizinkan: machineNames (Nama Mesin), tags. Nilai default: machineNames.

Tentukan nama atau tag host VM yang mengidentifikasi subset VM dalam grup sumber daya. Tag didukung untuk sumber daya yang dibuat hanya melalui azure Resource Manager.

MachineNames - Kriteria Filter
string. Opsional. Gunakan saat Destination = AzureVMs.

Berikan daftar nama host Azure VM seperti , , ffdbatau tag seperti Role:DB, , WebOS:Win8.1.ffweb

Catatan: Pemisah yang valid untuk tag meliputi ,(koma), :(colon) dan ;(semicolon). Saat menyediakan beberapa tag, tugas akan berjalan di semua VM yang berisi tag yang ditentukan. Secara default, tugas berjalan di semua VM.

vmsAdminUserName - Admin Masuk
string. Diperlukan saat Destination = AzureVMs.

Berikan nama pengguna akun administrator Azure VM.

vmsAdminPassword - Password
string. Diperlukan saat Destination = AzureVMs.

Berikan kata sandi untuk akun administrator Azure VM.

Input yang valid mencakup variabel yang ditentukan dalam alur build atau rilis seperti $(passwordVariable). Untuk mengamankan kata sandi, tandai sebagai secret.

TargetPath - Folder Tujuan
string. Diperlukan saat Destination = AzureVMs.

Tentukan jalur lokal pada VM target.

Input yang valid mencakup variabel lingkungan seperti $env:windir\BudgetIT\Web.

AdditionalArgumentsForBlobCopy - Argumen Opsional (untuk mengunggah file ke blob)
string.

Berikan argumen tambahan untuk AzCopy.exe yang dapat diterapkan saat mengunggah ke Blob seperti /NC:10.

Jika tidak ada argumen opsional yang ditentukan, argumen berikut ditambahkan secara default.

• /Y
• /SetContentType
• /Z
• /V
• /S - Ditambahkan ketika nama kontainer bukan $root.
• /BlobType:page - Ditambahkan ketika akun penyimpanan yang ditentukan adalah akun premium.
• /Pattern - Ditambahkan ketika jalur sumber adalah file. Disertakan dengan argumen opsional lain yang ditentukan.

AdditionalArgumentsForVMCopy - Argumen Opsional (untuk mengunduh file ke VM)
string. Opsional. Gunakan saat Destination = AzureVMs.

Berikan argumen tambahan untuk AzCopy.exe yang dapat diterapkan saat mengunduh ke VM seperti /NC:10.

Jika tidak ada argumen opsional yang ditentukan, berikut ini ditambahkan secara default.

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

enableCopyPrerequisites - Aktifkan Prasyarat Salin
boolean. Opsional. Gunakan saat ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Nilai default: false.

Saat diaktifkan, menggunakan sertifikat yang ditandatangani sendiri untuk mengonfigurasi pendengar Windows Remote Management (WinRM) pada port 5986 alih-alih protokol HTTPS. Diperlukan untuk melakukan operasi penyalinan pada Azure VM. Jika VM target menggunakan load balancer, konfigurasikan aturan NAT masuk untuk port target (5986). Hanya berlaku untuk VM ARM.

CopyFilesInParallel - Salin secara Paralel
boolean. Pilihan. Gunakan saat Destination = AzureVMs. Nilai default: true.

Menerima pengaturan default menyalin file secara paralel dengan VM target.

CleanTargetBeforeCopy - Bersihkan Target
boolean. Pilihan. Gunakan saat Destination = AzureVMs. Nilai default: false.

Menyetel nilai ini untuk true membersihkan folder tujuan sebelum melakukan tindakan salin.

skipCACheck - Uji Sertifikat
boolean. Pilihan. Gunakan saat Destination = AzureVMs. Nilai default: true.

Nilai default tidak akan memvalidasi bahwa sertifikat server ditandatangani oleh CA tepercaya sebelum menyambungkan melalui HTTPS.

outputStorageUri - URI Kontainer Penyimpanan
string.

Tentukan nama variabel yang digunakan untuk URI kontainer penyimpanan tempat file disalin. Hanya berlaku saat tujuan yang dipilih adalah Azure Blob.

outputStorageContainerSasToken - Token SAS Kontainer Penyimpanan
string.

Tentukan nama variabel yang digunakan untuk token SAS kontainer penyimpanan yang mengakses file yang disalin. Hanya berlaku saat tujuan yang dipilih adalah Azure Blob.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Apa yang baru di Versi 2.0: Menggunakan versi AzCopy yang lebih baru.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: azureps
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.103.0 atau lebih tinggi
Kategori tugas	Sebarkan