WindowsMachineFileCopy@2 - Tugas penyalinan file komputer Windows v2

Artikel
06/11/2024

Gunakan tugas ini untuk menyalin file ke komputer Windows jarak jauh.

Sintaks

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    MachineNames: # string. Required. Machines. 
    AdminUserName: # string. Required. Admin Login. 
    AdminPassword: # string. Required. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows Machine File Copy v2
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

Input

SourcePath - Sumber
string. Wajib diisi.

Jalur ke file yang akan disalin. Menentukan jalur absolut folder sumber atau file pada komputer lokal atau Berbagi UNC, seperti c:\fabrikamfiber atau \\fabrikamshare\fabrikamfiber. Anda dapat menggunakan variabel sistem yang telah ditentukan sebelumnya, seperti $(Build.Repository.LocalPath) (folder yang berfungsi di komputer agen), yang memudahkan untuk menentukan lokasi artefak build di komputer yang menghosting agen otomatisasi.

MachineNames - Mesin
string. Wajib diisi.

Menentukan daftar alamat IP komputer atau FQDN yang dipisahkan koma, secara opsional termasuk nomor port.
Misalnya: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 Anda juga dapat menentukan variabel output tugas lain, misalnya $(variableName), atau Anda dapat menggunakan nama Grup Sumber Daya Azure.

MachineNames - Mesin
string.

Menentukan daftar alamat IP komputer atau FQDN yang dipisahkan koma, secara opsional termasuk nomor port. Misalnya: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Anda juga dapat menentukan variabel output tugas lain, misalnya $(variableName), atau Anda dapat menggunakan nama Grup Sumber Daya Azure.

AdminUserName - Admin Masuk
string. Wajib diisi.

Menentukan nama pengguna domain atau akun administratif lokal pada host target. Format seperti domain\username, username, dan machine-name\username didukung. Format UPN, seperti username@domain.com, dan akun sistem bawaan, seperti NT Authority\System, tidak didukung.

AdminUserName - Admin Masuk
string.

AdminPassword - Password
string. Wajib diisi.

Menentukan kata sandi untuk login administrator untuk komputer target. Variabel yang ditentukan dalam alur build atau rilis, seperti $(passwordVariable), diterima. Anda dapat menandai variabel sebagai secret untuk mengamankannya.

AdminPassword - Password
string.

TargetPath - Folder Tujuan
string. Wajib diisi.

Menentukan jalur lokal pada komputer target atau jalur UNC yang dapat diakses untuk menyalin file dari sumbernya, seperti d:\fabrikam atau \\fabrikam\Web.

CleanTargetBeforeCopy - Bersihkan Target
boolean. Nilai default: false.

Menghapus semua file dalam folder target sebelum menyalin file baru ke dalamnya.

CopyFilesInParallel - Salin File secara Paralel
boolean. Nilai default: true.

Menyalin file ke semua komputer target secara paralel, yang dapat mempercepat proses penyalinan.

AdditionalArguments - Argumen Tambahan
string.

Menentukan argumen RoboCopy tambahan yang diterapkan saat menyalin file, seperti /min:33553332 /l.

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini untuk menyalin file aplikasi dan artefak lainnya, seperti skrip PowerShell dan modul PowerShell-DSC, yang diperlukan untuk menginstal aplikasi pada komputer Windows. Ini menggunakan RoboCopy, utilitas baris perintah yang dibuat untuk penyalinan data dengan cepat.

Mengapa saya mendapatkan kesalahan sistem 53 saat menggunakan tugas ini?

Biasanya ini terjadi ketika jalur yang ditentukan tidak dapat ditemukan. Ini mungkin karena firewall memblokir port yang diperlukan untuk berbagi file dan printer atau spesifikasi jalur yang tidak valid. Untuk detail selengkapnya, lihat Kesalahan 53 di TechNet.

Apa yang baru dalam Versi 2.0

Dukungan proksi sedang ditambahkan.
Menghapus dukungan mesin DTL warisan.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.104.0 atau lebih tinggi
Kategori tugas	Sebarkan

Bagikan melalui