xcopy

サブディレクトリを含むファイルとディレクトリをコピーします。

For examples of how to use this command, see Examples.

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

Remarks

• Using /z

  コピー フェーズ中に接続が失われた場合 (たとえば、サーバーがオフラインになると接続が切断された場合)、接続を再確立した後に再開されます。 /z also displays the percentage of the copy operation completed for each file.

• Using /y in the COPYCMD environment variable.

  You can use /y in the COPYCMD environment variable. You can override this command by using /-y on the command line. 既定では、上書きを求められます。

• 暗号化されたファイルのコピー

  暗号化されたファイルを EFS をサポートしていないボリュームにコピーすると、エラーが発生します。 最初にファイルを復号化するか、EFS をサポートするボリュームにファイルをコピーします。

• Appending files

  ファイルを追加するには、変換先に 1 つのファイルを指定しますが、ソースには複数のファイルを指定します (つまり、ワイルドカードまたは file1+file2+file3 形式を使用)。

• Default value for destination

  If you omit destination, the xcopy command copies the files to the current directory.

• Specifying whether destination is a file or directory

  If destination doesn't contain an existing directory and doesn't end with a backslash (), the following message appears:

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

  ファイルまたはファイルをファイルにコピーする場合は、F キーを押します。 ファイルまたはファイルをディレクトリにコピーする場合は、D キーを押します。

  You can suppress this message by using the /i command-line option, which causes xcopy to assume that the destination is a directory if the source is more than one file or a directory.

• Using the xcopy command to set archive attribute for destination files

  xcopy コマンドは、この属性がソース ファイルに設定されたかどうかにかかわらず、アーカイブ属性が設定されたファイルを作成します。 For more information about file attributes and attrib, see Related links.

• xcopy と diskcopy の比較

  サブディレクトリにファイルを含むディスクがあり、別の形式のディスクにコピーする場合は、xcopyの代わりに diskcopy コマンドを使用します。 diskcopy コマンドはトラックごとにディスク をコピーするため、ソース ディスクとコピー先ディスクの形式は同じである必要があります。 xcopy コマンドには、この要件はありません。 ディスク イメージの完全なコピーが必要な場合を除き、 xcopy を使用します。

• メモリ不足エラー

  ファイル名のパスが 255 文字を超えるファイルまたはフォルダーをコピーするために xcopy を実行すると、"メモリ不足" エラーが発生する可能性があります。

• の終了コード xcopy

  To process exit codes returned by xcopy, use the ErrorLevel parameter on the if command line in a batch program. For an example of a batch program that processes exit codes using if, see Related links. 次の表に、各終了コードと説明を示します。

  Exit code	Description
  0	エラーなしでファイルがコピーされました。
  1	コピーするファイルが見つかりませんでした。
  2	ユーザーが Ctrl キーを押しながら C キーを押して、 xcopyを終了しました。
  4	初期化エラーが発生しました。 メモリまたはディスク領域が不足しているか、コマンド ラインに無効なドライブ名または無効な構文を入力しました。
  5	ディスク書き込みエラーが発生しました。

Examples

1. To copy all the files and subdirectories (including any empty subdirectories) from drive A to drive B, type:

xcopy a: b: /s /e

2. To include any system or hidden files in the previous example, add the /h command-line option as follows:

xcopy a: b: /s /e /h

3. To update files in the \Reports directory with the files in the \Rawdata directory that have changed since December 29, 1993, type:

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

4. To update all the files that exist in \Reports in the previous example, regardless of date, type:

xcopy \rawdata \reports /u

5. To obtain a list of the files to be copied by the previous command (that is, without actually copying the files), type:

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

xcopy.out ファイルには、コピーされるすべてのファイルが一覧表示されます。

6. To copy the \Customer directory and all subdirectories to the directory \\Public\Address on network drive H:, retain the read-only attribute, and be prompted when a new file is created on H:, type:

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

7. To issue the previous command, ensure that xcopy creates the \Address directory if it doesn't exist, and suppress the message that appears when you create a new directory, add the /i command-line option as follows:

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

8. You can create a batch program to perform xcopy operations and use the batch if command to process the exit code if an error occurs. たとえば、次のバッチ プログラムでは、 xcopy のソースパラメーターと宛先パラメーターに置き換え可能なパラメーターが使用されます。

@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

上記のバッチ プログラムを使用して、C:\Prgmcode ディレクトリとそのサブディレクトリ内のすべてのファイルを B ドライブにコピーするには、次のように入力します。

copyit c:\prgmcode b:

The command interpreter substitutes C:\Prgmcode for %1 and B: for %2, then uses xcopy with the /e and /s command-line options. If xcopy encounters an error, the batch program reads the exit code and goes to the label indicated in the appropriate IF ERRORLEVEL statement, then displays the appropriate message and exits from the batch program.

9. This example copies all the non-empty directories, plus files with the associated file extension after the asterisk symbol.

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

In the preceding example, this particular source parameter value .\toc*.yml copies the same 3 files even if its two path characters .\ were removed. However, no files would be copied if the asterisk wildcard was removed from the source parameter, making it just .\toc.yml.

Related links

• Copy
• Move
• Dir
• Attrib
• Diskcopy
• If
• コマンド ライン構文の記号