robocopy
Menyalin data file dari satu lokasi ke lokasi lain.
Sintaks
robocopy <source> <destination> [<file>[ ...]] [<options>]
Misalnya, untuk menyalin file bernama yearly-report.mov dari c:\reports ke berbagi file \\marketing\videos sambil mengaktifkan multi-threading untuk performa yang lebih tinggi (dengan parameter /mt) dan kemampuan untuk memulai ulang transfer jika terganggu (dengan parameter /z), ketik:
robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z
Penting
Jika ada data yang disalin dari akar perangkat, direktori tujuan akan mengadopsi atribut "tersembunyi" selama proses penyalinan.
Parameter
| Parameter | Deskripsi |
|---|---|
<source> |
Menentukan jalur ke direktori sumber. |
<destination> |
Menentukan jalur ke direktori tujuan. |
<file> |
Menentukan berkas atau berkas yang akan disalin. Karakter kartubebas (* atau ?) didukung. Jika Anda tidak menentukan parameter ini, *.* digunakan sebagai nilai default. |
<options> |
Menentukan opsi untuk digunakan dengan perintah robocopy , termasuk opsi salin, file, coba lagi, pengelogan, dan pekerjaan . |
Opsi salin
| Opsi | Deskripsi |
|---|---|
| /dtk | Menyalin subdirektori. Opsi ini secara otomatis mengecualikan direktori kosong. |
| /e | Menyalin subdirektori. Opsi ini secara otomatis menyertakan direktori kosong. |
/Imamat:<n> |
Menyalin hanya tingkat n teratas dari pohon direktori sumber. |
| /z | Menyalin file dalam mode yang dapat dimulai ulang. Dalam mode yang dapat dihidupkan ulang, jika salinan file terganggu, robocopy dapat mengambil tempat yang ditinggalkannya daripada mengolah ulang seluruh file. |
| /b | Menyalin file dalam mode pencadangan. Dalam mode pencadangan, robocopy mengambil alih pengaturan izin file dan folder (ACL), yang mungkin memblokir akses. |
| /zb | Menyalin file dalam mode yang dapat dimulai ulang. Jika akses file ditolak, beralihlah ke mode cadangan. |
| /J | Menyalin menggunakan I/O yang tidak dibuffer (disarankan untuk file besar). |
| /efsraw | Menyalin semua file terenkripsi dalam mode RAW EFS. |
/Salinan:<copyflags> |
Menentukan properti file mana yang akan disalin. Nilai yang valid untuk opsi ini adalah:
|
/dcopy:<copyflags> |
Menentukan apa yang akan disalin dalam direktori. Nilai yang valid untuk opsi ini adalah:
|
| /Sec | Menyalin file dengan keamanan (setara dengan /copy:DATS). |
| /copyall | Menyalin semua informasi file (setara dengan /copy:DATSOU). |
| /nocopy | Menyalin tidak ada informasi file (berguna dengan /hapus menyeluruh). |
| /secfix | Memperbaiki keamanan file pada semua file, bahkan file yang dilewati. |
| /timfix | Memperbaiki waktu file pada semua file, bahkan file yang dilewati. |
| /Membersihkan | Menghapus file dan direktori tujuan yang tidak lagi ada di sumbernya. Menggunakan opsi ini dengan opsi /e dan direktori tujuan, memungkinkan pengaturan keamanan direktori tujuan tidak ditimpa. |
| /Mir | Mencerminkan pohon direktori (setara dengan /e plus /purge). Menggunakan opsi ini dengan opsi /e dan direktori tujuan, menimpa pengaturan keamanan direktori tujuan. |
| /Mov | Memindahkan file, dan menghapusnya dari sumber setelah disalin. |
| /Bergerak | Memindahkan file dan direktori, dan menghapusnya dari sumber setelah disalin. |
| /a+:[RASHCNET] | Menambahkan atribut yang ditentukan ke file yang disalin. Nilai yang valid untuk opsi ini adalah:
|
| /a-:[RASHCNETO] | Menghapus atribut yang ditentukan dari file yang disalin. Nilai yang valid untuk opsi ini adalah:
|
| /create | Membuat pohon direktori dan file panjang nol saja. |
| /Lemak | Membuat file tujuan hanya dengan menggunakan nama file FAT sepanjang 8,3 karakter. |
| /256 | Menonaktifkan dukungan untuk jalur yang lebih panjang dari 256 karakter. |
/Mon:<n> |
Memantau sumber dan menjalankan lagi ketika lebih dari n perubahan terdeteksi. |
/Mot:<m> |
Memantau sumber dan menjalankan lagi dalam m menit jika perubahan terdeteksi. |
| /rh:hhmm-hhmm | Menentukan waktu eksekusi ketika salinan baru dapat dimulai. |
| /Pf | Pemeriksaan berjalan berdasar per file (bukan per-pass). |
/ipg:<n> |
Menentukan celah antar-paket untuk membebaskan bandwidth pada garis lambat. |
| /Sj | Menyalin persimpangan (tautan lunak) ke jalur tujuan alih-alih menautkan target. |
| /Sl | Jangan ikuti tautan simbolis dan buat salinan tautan. |
/Gunung:<n> |
Membuat salinan multi-utas dengan utas n . n harus berupa bilangan bulat antara 1 dan 128. Nilai default untuk n adalah 8. Untuk performa yang lebih baik, alihkan output Anda menggunakan opsi /log . Parameter /mt tidak dapat digunakan dengan parameter /ipg dan /efsraw . |
| /nodcopy | Menyalin tidak ada info direktori (default /dcopy:DA selesai). |
| /nooffload | Menyalin file tanpa menggunakan mekanisme Windows Copy Offload. |
| /Kompres | Meminta kompresi jaringan selama transfer file, jika berlaku. |
| /Jarang | Memungkinkan mempertahankan status file yang jarang selama penyalinan. |
Penting
Saat menggunakan opsi salin /secfix , tentukan jenis informasi keamanan yang ingin Anda salin, menggunakan salah satu opsi salinan tambahan ini:
- /copyall
- /copy:o
- /copy:s
- /copy:u
- /Sec
Catatan
Parameter /mt diperkenalkan di Windows Server 2008 R2 dan fungsionalitasnya berlaku untuk versi Windows Server saat ini.
Salin opsi pembatasan file
| Opsi | Deskripsi |
|---|---|
/iomaxsize:<n>[kmg] |
Ukuran i/o maks yang diminta per siklus baca/tulis dalam nkilobyte, megabyte, atau gigabyte. |
/iorate:<n>[kmg] |
Tingkat i/o yang diminta dalam nkilobyte megabyte, atau gigabyte per detik. |
/threshold:<n>[kmg] |
Ambang ukuran file untuk pembatasan dalam nkilobyte, megabyte, atau gigabyte (lihat Komentar). |
Opsi pembatasan ini digunakan untuk menentukan bandwidth I/O maksimum yang diizinkan Robocopy untuk digunakan dalam byte per detik. Jika tidak menentukan dalam byte per detik, seluruh angka dapat digunakan jika k, m, atau g ditentukan. Bandwidth I/O minimum yang dibatasi 524288 byte bahkan jika nilai yang lebih rendah ditentukan.
Opsi pemilihan file
| Opsi | Deskripsi |
|---|---|
| /J | Menyalin hanya file yang atribut Arsipnya diatur. |
| /m | Salin hanya file yang atribut Arsipnya diatur, dan reset atribut Arsip . |
/ia:[RASHCNETO] |
Hanya menyertakan file yang salah satu atribut yang ditentukan yang diatur. Nilai yang valid untuk opsi ini adalah:
|
/Xa:[RASHCNETO] |
Mengecualikan file yang salah satu atribut yang ditentukan diatur. Nilai yang valid untuk opsi ini adalah:
|
/xf <filename>[ ...] |
Mengecualikan file yang cocok dengan nama atau jalur yang ditentukan. Karakter kartubebas (* dan ?) didukung. |
/Xd <directory>[ ...] |
Mengecualikan direktori yang cocok dengan nama dan jalur yang ditentukan. |
| /Xc | Mengecualikan file yang ada dengan tanda waktu yang sama, tetapi ukuran file yang berbeda. |
| /xn | File direktori sumber yang lebih baru dari tujuan dikecualikan dari salinan. |
| /Xo | File direktori sumber yang lebih lama dari tujuan dikecualikan dari salinan. |
| /Xx | Mengecualikan file dan direktori tambahan yang ada di tujuan tetapi bukan sumbernya. Tidak termasuk file tambahan tidak akan menghapus file dari tujuan. |
| /Xl | Mengecualikan file dan direktori "kesepian" yang ada di sumber tetapi bukan tujuannya. Mengecualikan file kesepian mencegah file baru ditambahkan ke tujuan. |
| /Im | Sertakan file yang dimodifikasi (waktu perubahan yang berbeda). |
| /is | Menyertakan file yang sama. File yang sama identik dalam nama, ukuran, waktu, dan semua atribut. |
| /Itu | Termasuk file "di-tweak". File yang di-tweak memiliki nama, ukuran, dan waktu yang sama, tetapi atribut yang berbeda. |
/Maks:<n> |
Menentukan ukuran file maksimum (untuk mengecualikan file yang lebih besar dari n byte). |
/Min:<n> |
Menentukan ukuran file minimum (untuk mengecualikan file yang lebih kecil dari n byte). |
/maxage:<n> |
Menentukan usia file maksimum (untuk mengecualikan file yang lebih lama dari n hari atau tanggal). |
/minage:<n> |
Menentukan usia file minimum (kecualikan file yang lebih baru dari n hari atau tanggal). |
/maxlad:<n> |
Menentukan tanggal akses terakhir maksimum (tidak termasuk file yang tidak digunakan sejak n). |
/minlad:<n> |
Menentukan tanggal akses terakhir minimum (tidak termasuk file yang digunakan sejak n) Jika n kurang dari 1900, n menentukan jumlah hari. Jika tidak, n menentukan tanggal dalam format YYYYMMDD. |
| /Xj | Mengecualikan titik persimpangan, yang biasanya disertakan secara default. |
| /fft | Mengasumsikan waktu file FAT (presisi dua detik). |
| /Dst | Mengimbangi perbedaan waktu DST satu jam. |
| /xjd | Mengecualikan titik persimpangan untuk direktori. |
| /xjf | Mengecualikan titik persimpangan untuk file. |
Opsi coba lagi
| Opsi | Deskripsi |
|---|---|
/R:<n> |
Menentukan jumlah percobaan kembali pada salinan yang gagal. Nilai default n adalah 1.000.000 (satu juta percobaan ulang). |
/W:<n> |
Menentukan waktu tunggu antara percobaan kembali, dalam detik. Nilai default n adalah 30 (waktu tunggu 30 detik). |
| /Reg | Menyimpan nilai yang ditentukan dalam opsi /r dan /w sebagai pengaturan default dalam registri. |
| /Tbd | Menentukan bahwa sistem menunggu nama berbagi ditentukan (kesalahan coba lagi 67). |
| /lfsm | Beroperasi dalam mode ruang kosong rendah yang memungkinkan penyalinan, jeda, dan lanjutkan (lihat Komentar). |
/lfsm:<n>[kmg] |
Menentukan ukuran lantai dalam nkilobyte, megabyte, atau gigabyte. |
Opsi pengelogan
| Opsi | Deskripsi |
|---|---|
| /L | Menentukan bahwa file hanya akan dicantumkan (dan tidak disalin, dihapus, atau diberi stempel waktu). |
| /X | Melaporkan semua file tambahan, bukan hanya file yang dipilih. |
| /v | Menghasilkan output verbose, dan menunjukkan semua file yang dilewati. |
| /Ts | Menyertakan stempel waktu file sumber dalam output. |
| /Fp | Menyertakan nama jalur lengkap file dalam output. |
| /bytes | Mencetak ukuran sebagai byte. |
| /Ns | Menentukan bahwa ukuran file tidak akan dicatat. |
| /Nc | Menentukan bahwa kelas file tidak akan dicatat. |
| /nfl | Menentukan bahwa nama file tidak akan dicatat. |
| /ndl | Menentukan bahwa nama direktori tidak akan dicatat. |
| /np | Menentukan bahwa kemajuan operasi penyalinan (jumlah file atau direktori yang disalin sejauh ini) tidak akan ditampilkan. |
| /Eta | Menunjukkan perkiraan waktu kedatangan (ETA) dari file yang disalin. |
/Log:<logfile> |
Menulis keluaran status ke file log (menimpa file log yang ada). |
/log+:<logfile> |
Menulis output status ke file log (menambahkan output ke file log yang ada). |
/unilog:<logfile> |
Menulis output status ke file log sebagai teks unicode (menimpa file log yang ada). |
/unilog+:<logfile> |
Menulis output status ke file log sebagai teks Unicode (menambahkan output ke file log yang ada). |
| /Tee | Menulis output status ke jendela konsol, dan ke file log. |
| /njh | Menentukan bahwa tidak ada header pekerjaan. |
| /njs | Menentukan bahwa tidak ada ringkasan pekerjaan. |
| /unicode | Menampilkan output status sebagai teks unicode. |
Opsi pekerjaan
| Opsi | Deskripsi |
|---|---|
/Pekerjaan:<jobname> |
Menentukan bahwa parameter akan berasal dari file pekerjaan bernama. Untuk menjalankan /job:jobname, Anda harus terlebih dahulu menjalankan /save:jobname parameter untuk membuat file pekerjaan. |
/Menyimpan:<jobname> |
Menentukan bahwa parameter akan disimpan ke file pekerjaan bernama. Ini harus dijalankan sebelum menjalankan /job:jobname. Semua opsi salin, coba lagi, dan pengelogan harus ditentukan sebelum parameter ini. |
| /Berhenti | Keluar setelah memproses baris perintah (untuk melihat parameter). |
| /nosd | Menunjukkan bahwa tidak ada direktori sumber yang ditentukan. |
| /nodd | Menunjukkan bahwa tidak ada direktori tujuan yang ditentukan. |
| /Jika | Menyertakan file yang ditentukan. |
Keterangan
Menggunakan /PURGE atau /MIR pada direktori akar volume yang sebelumnya menyebabkan robocopy menerapkan operasi yang diminta pada file di dalam direktori Informasi Volume Sistem juga. Ini tidak lagi terjadi seolah-olah ditentukan, robocopy akan melewati file atau direktori apa pun dengan nama tersebut di direktori sumber dan tujuan tingkat atas dari sesi salin.
Klasifikasi file yang dimodifikasi hanya berlaku ketika sistem file sumber dan tujuan mendukung perubahan tanda waktu, seperti NTFS, dan file sumber dan tujuan memiliki waktu perubahan yang berbeda tetapi sebaliknya sama. File-file ini tidak disalin secara default. Tentukan /IM untuk menyertakannya.
Permintaan bendera /DCOPY:E yang memperluas penyalinan atribut harus dicoba untuk direktori. Robocopy akan berlanjut jika EA direktori tidak dapat disalin. Bendera ini tidak disertakan dalam /COPYALL.
Jika /IoMaxSize atau /IoRate ditentukan, robocopy akan mengaktifkan pembatasan file salin untuk mengurangi beban sistem. Keduanya dapat disesuaikan dengan nilai optimal dan parameter salin, tetapi sistem dan robocopy diizinkan untuk menyesuaikannya dengan nilai yang diizinkan seperlunya.
Jika /Threshold digunakan, ini menentukan ukuran file minimum untuk melibatkan pembatasan. File di bawah ukuran tersebut tidak akan dibatasi. Nilai untuk ketiga parameter dapat diikuti oleh karakter akhiran opsional seperti [KMG] (kilobyte, megabyte, gigabyte).
Menggunakan /LFSM meminta robocopy untuk beroperasi dalam 'mode ruang kosong rendah'. Dalam mode ini, robocopy akan dijeda setiap kali salinan file akan menyebabkan ruang kosong volume tujuan berada di bawah nilai 'lantai'. Nilai ini dapat ditentukan secara eksplisit menggunakan bendera /LFSM:n[KMG].
Jika /LFSM ditentukan tanpa nilai lantai eksplisit, lantai diatur ke 10% dari ukuran volume tujuan. Mode ruang kosong rendah tidak kompatibel dengan /MT dan /EFSRAW.
Keluar dari kode (pengembalian)
| Nilai | Deskripsi |
|---|---|
| 0 | Tidak ada file yang disalin. Tidak ada kegagalan yang ditemui. Tidak ada file yang tidak cocok. File sudah ada di direktori tujuan; oleh karena itu, operasi penyalinan dilewati. |
| 1 | Semua file berhasil disalin. |
| 2 | Ada beberapa file tambahan di direktori tujuan yang tidak ada di direktori sumber. Tidak ada file yang disalin. |
| 3 | Beberapa file disalin. Ada file tambahan. Tidak ada kegagalan yang ditemui. |
| 5 | Beberapa file disalin. Beberapa file tidak cocok. Tidak ada kegagalan yang ditemui. |
| 6 | Ada file tambahan dan file yang tidak cocok. Tidak ada file yang disalin dan tidak ada kegagalan yang ditemui yang berarti bahwa file sudah ada di direktori tujuan. |
| 7 | File disalin, ada ketidakcocokan file, dan file tambahan ada. |
| 8 | Beberapa file tidak disalin. |
Catatan
Nilai apa pun yang sama dengan atau lebih besar dari 8 menunjukkan bahwa setidaknya ada satu kegagalan selama operasi penyalinan.
Contoh
Sangat disarankan saat menjalankan robocopy perintah untuk membuat file log yang dapat dilihat setelah proses selesai memverifikasi integritasnya. Dalam contoh berikut, masing-masing menggunakan /LOG: parameter . Untuk menambahkan informasi log apa pun ke file log yang sama, gunakan parameter sebagai gantinya /LOG+: .
Untuk menyalin semua file dan subdirektori, termasuk direktori kosong, dari folder "Rekaman" ke folder "Cadangan" pada drive "D", ketik yang berikut ini:
robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log
Untuk mencerminkan konten folder "Rekaman" ke folder "Cadangan" pada drive "D", hapus file apa pun di tujuan yang tidak ada di sumber dengan 2 percobaan ulang dan menunggu 5 detik di antara setiap coba lagi, ketik berikut ini:
robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5 /LOG:C:\Logs\Backup.log
Untuk menyalin semua file dan subdirektori yang tidak kosong dari folder "Rekaman" ke folder "Cadangan" pada drive "D", mempertahankan data file, atribut, dan tanda waktu dengan 16 operasi salin multi-alur, ketik berikut:
robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16 /LOG:C:\Logs\Backup.log
Untuk memindahkan file dan subdirektori, tidak termasuk direktori kosong, dari folder "Rekaman" ke folder "Cadangan" pada drive "D", dan kecualikan file yang lebih lama dari 7 hari, ketik berikut ini:
robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV /LOG:C:\Logs\Backup.log
Untuk menyalin semua file dan subdirektori, termasuk direktori kosong, dari folder "Rekaman" ke folder "Cadangan" pada drive "D" memperlihatkan perkiraan waktu untuk setiap file dan menghapus file dan direktori apa pun di tujuan yang tidak ada dari sumbernya, ketik berikut ini:
robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE /LOG:C:\Logs\Backup.log
Untuk menyalin semua file dan subdirektori dari folder bernama "Records" pada drive "C" ke folder bernama "Backup" pada drive "D" sambil membatasi laju I/O menjadi 1 megabyte per detik selama operasi salin, ketik berikut ini:
robocopy C:\Records D:\Backup /iorate:1m