xcopy

Menyalin file dan direktori, termasuk subdirektori.

Untuk contoh cara menggunakan perintah ini, lihat Contoh.

Syntax

xcopy <Source> [<Destination>] [/w] [/p] [/c] [/v] [/q] [/f] [/l] [/g] [/d [:MM-DD-YYYY]] [/u] [/i] [/s [/e]] [/t] [/k] [/r] [/h] [{/a | /m}] [/n] [/o] [/x] [/exclude:FileName1[+[FileName2]][+[FileName3]]] [{/y | /-y}] [/z] [/b] [/j] [/compress]

Parameters

Parameter	Description
<Sumber>	Required. Menentukan lokasi dan nama file yang ingin Anda salin. Parameter ini harus mencakup drive atau jalur.
[<Tujuan>]	Menentukan tujuan file yang ingin Anda salin. Parameter ini dapat mencakup huruf kandar dan titik dua, nama direktori, nama file, atau kombinasinya.
/w	Menampilkan pesan berikut dan menunggu respons Anda sebelum mulai menyalin file: Tekan tombol apa pun untuk mulai menyalin file
/p	Meminta Anda untuk mengonfirmasi apakah Anda ingin membuat setiap file tujuan.
/c	Ignores errors.
/v	Memverifikasi setiap file karena ditulis ke file tujuan untuk memastikan bahwa file tujuan identik dengan file sumber.
/q	Menekan tampilan xcopy pesan.
/f	Menampilkan nama file sumber dan tujuan saat menyalin.
/l	Menghasilkan daftar file yang akan disalin, tetapi tidak secara aktif menyalin file.
/g	Membuat file tujuan yang didekripsi saat tujuan tidak mendukung enkripsi.
/d [:MM-DD-YYYY]	Menyalin file sumber yang diubah pada atau setelah tanggal yang ditentukan saja. Jika Anda tidak menyertakan nilai MM-DD-YYYY, salin semua file sumber yang lebih baru dari file tujuan yang ada. xcopy Opsi baris perintah ini memungkinkan Anda memperbarui file yang telah berubah.
/u	Menyalin file dari sumber yang hanya ada di tujuan .
/i	Jika sumber adalah direktori atau berisi karakter pengganti dan tujuan tidak ada, xcopy asumsikan tujuan menentukan nama direktori dan membuat direktori baru. Kemudian, xcopy salin semua file yang ditentukan ke direktori baru. Secara default, xcopy meminta Anda untuk menentukan apakah tujuan adalah file atau direktori.
/s	Menyalin direktori dan subdirektori, kecuali jika kosong. Jika Anda menghilangkan /s, xcopy berfungsi dalam satu direktori.
/e	Menyalin semua subdirektori, bahkan jika kosong. Gunakan /e dengan opsi baris perintah /s dan /t .
/t	Menyalin struktur subdirektori (yaitu, pohon) saja, bukan file. Untuk menyalin direktori kosong, Anda harus menyertakan opsi baris perintah /e .
/k	Menyalin file dan mempertahankan atribut baca-saja pada file tujuan jika ada pada file sumber . Secara default, xcopy menghapus atribut baca-saja.
/r	Menyalin file baca-saja.
/h	Menyalin file dengan atribut file tersembunyi dan sistem. Secara default, xcopy tidak menyalin file tersembunyi atau sistem
/a	Hanya menyalin file sumber yang memiliki atribut file arsip yang ditetapkan. /a tidak memodifikasi atribut file arsip dari file sumber. Untuk informasi tentang cara mengatur atribut file arsip dengan menggunakan attrib, lihat Tautan terkait.
/m	Menyalin file sumber yang memiliki atribut file arsip yang ditetapkan. Tidak seperti /a, /m menonaktifkan atribut file arsip dalam file yang ditentukan dalam sumber. Untuk informasi tentang cara mengatur atribut file arsip dengan menggunakan attrib, lihat Tautan terkait.
/n	Membuat salinan dengan menggunakan nama file pendek atau direktori NTFS. /n diperlukan saat Anda menyalin file atau direktori dari volume NTFS ke volume FAT atau ketika konvensi penamaan sistem file FAT (yaitu, 8.3 karakter) diperlukan pada sistem file tujuan . Sistem file tujuan dapat berupa FAT atau NTFS.
/o	Menyalin kepemilikan file dan informasi daftar kontrol akses diskresi (DACL).
/x	Menyalin pengaturan audit file dan informasi daftar kontrol akses sistem (SACL) (menyiratkan /o).
/exclude:FileName1[+[FileName2]][+[FileName3]( )]	Menentukan daftar file. Setidaknya satu file harus ditentukan. Setiap file berisi string pencarian dengan setiap string pada baris terpisah dalam file. Ketika salah satu string cocok dengan bagian mana pun dari jalur absolut file yang akan disalin, file tersebut dikecualikan agar tidak disalin. Misalnya, menentukan string obj akan mengecualikan semua file di bawah direktori obj atau semua file dengan ekstensi .obj .
/y	Menekan permintaan untuk mengonfirmasi bahwa Anda ingin menimpa file tujuan yang ada.
/-y	Meminta untuk mengonfirmasi bahwa Anda ingin menimpa file tujuan yang sudah ada.
/z	Menyalin melalui jaringan dalam mode yang dapat dimulai ulang.
/b	Menyalin tautan simbolis alih-alih file. Parameter ini diperkenalkan di Windows Vista®.
/j	Menyalin file tanpa buffering. Direkomendasikan untuk file yang sangat besar. Parameter ini ditambahkan di Windows Server 2008 R2.
/compress	Minta kompresi jaringan selama transfer file jika berlaku.
/[-]sparse	Mengaktifkan atau menonaktifkan mempertahankan status file jarang selama proses penyalinan. Jika kedua parameter ditentukan, /-jarang mengganti /jarang.
/noclone	Tidak mencoba memblokir kloning sebagai pengoptimalan.
/?	Menampilkan bantuan pada prompt perintah.

Remarks

• Using /z

  Jika Anda kehilangan koneksi selama fase salin (misalnya, jika server akan offline memisahkan koneksi), koneksi akan dilanjutkan setelah Anda membangun kembali koneksi. /z juga menampilkan persentase operasi penyalinan yang diselesaikan untuk setiap file.

• Menggunakan /y dalam variabel lingkungan COPYCMD.

  Anda dapat menggunakan /y di variabel lingkungan COPYCMD. Anda dapat mengganti perintah ini dengan menggunakan /-y pada baris perintah. Secara default, Anda diminta untuk menimpa.

• Menyalin file terenkripsi

  Menyalin file terenkripsi ke volume yang tidak mendukung EFS menghasilkan kesalahan. Dekripsi file terlebih dahulu atau salin file ke volume yang mendukung EFS.

• Appending files

  Untuk menambahkan file, tentukan satu file untuk tujuan, tetapi beberapa file untuk sumber (yaitu, dengan menggunakan wildcard atau format file1+file2+file3).

• Nilai default untuk tujuan

  Jika Anda menghilangkan tujuan, perintah menyalin xcopy file ke direktori saat ini.

• Menentukan apakah tujuan adalah file atau direktori

  Jika destination tidak berisi direktori yang ada dan tidak diakhiri dengan garis miring terbalik (), pesan berikut muncul:

  Does <Destination> specify a file name or directory name on the target(F = file, D = directory)?
  

  Tekan F jika Anda ingin file atau file disalin ke file. Tekan D jika Anda ingin file atau file disalin ke direktori.

  Anda dapat menekan pesan ini dengan menggunakan opsi baris perintah /i , yang menyebabkan xcopy asumsi bahwa tujuannya adalah direktori jika sumbernya lebih dari satu file atau direktori.

• Menggunakan xcopy perintah untuk mengatur atribut arsip untuk file tujuan

  Perintah xcopy membuat file dengan set atribut arsip, apakah atribut ini diatur dalam file sumber atau tidak. Untuk informasi selengkapnya tentang atribut file dan attrib, lihat Tautan terkait.

• Membandingkan xcopy dan diskcopy

  Jika Anda memiliki disk yang berisi file dalam subdirektori dan Anda ingin menyalinnya ke disk yang memiliki format berbeda, gunakan xcopy perintah alih-alih diskcopy. diskcopy Karena perintah menyalin disk yang dilacak menurut trek, disk sumber dan tujuan Anda harus memiliki format yang sama. Perintah xcopy tidak memiliki persyaratan ini. Gunakan xcopy kecuali Anda memerlukan salinan gambar disk lengkap.

• Kesalahan memori tidak cukup

  Kesalahan "memori tidak mencukupi" dapat terjadi jika berjalan xcopy untuk menyalin file atau folder yang jalur nama filenya lebih besar dari 255 karakter.

• Kode keluar untuk xcopy

  Untuk memproses kode keluar yang dikembalikan oleh xcopy, gunakan parameter ErrorLevel pada baris perintah if dalam program batch. Untuk contoh program batch yang memproses kode keluar menggunakan if, lihat Tautan terkait. Tabel berikut mencantumkan setiap kode keluar dan deskripsi.

  Exit code	Description
  0	File disalin tanpa kesalahan.
  1	Tidak ada file yang ditemukan untuk disalin.
  2	Pengguna menekan CTRL+C untuk mengakhiri xcopy.
  4	Terjadi kesalahan inisialisasi. Memori atau ruang disk tidak cukup, atau Anda memasukkan nama drive yang tidak valid atau sintaksis yang tidak valid pada baris perintah.
  5	Terjadi kesalahan penulisan disk.

Examples

1. Untuk menyalin semua file dan subdirektori (termasuk subdirektori kosong) dari drive A ke drive B, ketik:

xcopy a: b: /s /e

2. Untuk menyertakan sistem atau file tersembunyi apa pun dalam contoh sebelumnya, tambahkan opsi baris perintah /h sebagai berikut:

xcopy a: b: /s /e /h

3. Untuk memperbarui file di direktori \Reports dengan file di direktori \Rawdata yang telah berubah sejak 29 Desember 1993, ketik:

xcopy \rawdata \reports /d:12-29-1993

4. Untuk memperbarui semua file yang ada di \Reports dalam contoh sebelumnya, terlepas dari tanggalnya, ketik:

xcopy \rawdata \reports /u

5. Untuk mendapatkan daftar file yang akan disalin dengan perintah sebelumnya (yaitu, tanpa benar-benar menyalin file), ketik:

xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out

File xcopy.out mencantumkan setiap file yang akan disalin.

6. Untuk menyalin direktori \Customer dan semua subdirektori ke direktori \\Public\Address pada drive jaringan H:, pertahankan atribut hanya-baca, dan diminta saat file baru dibuat di H:, ketik:

xcopy \customer h:\public\address /s /e /k /p

7. Untuk mengeluarkan perintah sebelumnya, pastikan bahwa xcopy membuat direktori \Address jika tidak ada, dan tekan pesan yang muncul saat Anda membuat direktori baru, tambahkan opsi baris perintah /i sebagai berikut:

xcopy \customer h:\public\address /s /e /k /p /i

8. Anda dapat membuat program batch untuk melakukan xcopy operasi dan menggunakan perintah batch if untuk memproses kode keluar jika terjadi kesalahan. Misalnya, program batch berikut menggunakan parameter yang dapat diganti untuk xcopy parameter sumber dan tujuan:

@echo off
rem COPYIT.BAT transfers all files in all subdirectories of
rem the source drive or directory (%1) to the destination
rem drive or directory (%2)
xcopy %1 %2 /s /e
if errorlevel 4 goto lowmemory
if errorlevel 2 goto abort
if errorlevel 0 goto exit
:lowmemory
echo Insufficient memory to copy files or
echo invalid drive or command-line syntax.
goto exit
:abort
echo You pressed CTRL+C to end the copy operation.
goto exit
:exit

Untuk menggunakan program batch sebelumnya untuk menyalin semua file di direktori C:\Prgmcode dan subdirektorinya untuk mendorong B, ketik:

copyit c:\prgmcode b:

Penerjemah perintah mengganti C:\Prgmcode untuk %1 dan B: untuk %2, lalu digunakan xcopy dengan opsi baris perintah /e dan /s . Jika xcopy mengalami kesalahan, program batch membaca kode keluar dan pergi ke label yang ditunjukkan dalam pernyataan IF ERRORLEVEL yang sesuai, lalu menampilkan pesan yang sesuai dan keluar dari program batch.

9. Contoh ini menyalin semua direktori yang tidak kosong, ditambah file dengan ekstensi file terkait setelah simbol tanda bintang.

xcopy .\toc*.yml ..\..\Copy-To\ /S /Y

rem Output example.
rem  .\d1\toc.yml
rem  .\d1\d12\toc.yml
rem  .\d2\toc.yml
rem  3 File(s) copied

Dalam contoh sebelumnya, nilai parameter sumber khusus ini .\toc*.yml menyalin 3 file yang sama bahkan jika dua karakter jalurnya .\ dihapus. Namun, tidak ada file yang akan disalin jika wildcard tanda bintang dihapus dari parameter sumber, menjadikannya hanya .\toc.yml.

Related links

• Copy
• Move
• Dir
• Attrib
• Diskcopy
• If
• Kunci Sintaks Baris Perintah