> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 파일 복사 (xbcp.exe)

> 파일 복사 (xbcp.exe)

이 도구를 사용해 원격 콘솔에서 또는 원격 콘솔로 파일을 하나 이상 복사합니다.

| 열 1                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------- |
| **xbcp** *source* \[*target*] \[/A\[*:attributes*] ] \[/B] \[/M] \[/S\[*:levels*] ] \[/W] \[/X\[*:address*] \[*+accesskey*] \[/title] ] |

| 옵션                                        | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *source*                                  | 원본 파일의 이름 또는 디렉터리입니다. 파일 이름에 와일드카드 문자가 지원됩니다. 자세한 내용은 이 문서의 뒤에 있는 [설명](#remarks) 섹션을 참고하세요.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| *target*                                  | 대상 파일의 이름 또는 디렉터리입니다. 여러 파일을 복사할 때는 대상이 디렉터리여야 합니다. 대상 디렉터리가 없으면 생성됩니다. 자세한 내용은 이 문서의 뒤에 있는 [설명](#remarks) 섹션을 참고하세요.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| /A\[*:attributes*]                        | 지정된 특성이 있는 파일만 복사합니다. 특성이 지정되지 않은 경우, 숨겨져 있지 않은 모든 비시스템 파일을 복사합니다.<br />• **H** 숨김 파일<br />• **R** 읽기 전용 파일<br />• **S** 시스템 파일<br />• **A** 아카이빙 준비가 된 파일<br />• **-** 부정 접두사; 지정된 플래그가 *없는* 파일을 복사합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| /B                                        | 최소 형식을 사용합니다. 파일 이름만 표시됩니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| /M                                        | 모든 파일이 전송된 후 전송 성능 메트릭의 요약을 인쇄합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| /S\[*:levels*]                            | 지정된 디렉터리와 모든 하위 디렉터리에 있는 파일을 복사합니다. \_levels\_는 하위 디렉터리 재귀 깊이를 지정하는 선택적 정수입니다. 예를 들어 **xbcp /S:1**은 지정된 디렉터리와 그 아래 한 수준의 하위 디렉터리만 처리합니다. **/S**가 지정되었지만 \_levels\_가 지정되지 않은 경우 모든 하위 디렉터리가 포함됩니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| /W                                        | FILE\_SHARE\_WRITE 의미 체계를 사용해 파일을 복사합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| /X\[*:address*] \[*+accesskey*] \[/title] | • 이 옵션을 사용하여 기본 콘솔을 변경하지 않고 대상 콘솔의 호스트 이름 또는 주소(콘솔에 **Tools IP**로 표시됨)를 지정합니다. 콘솔의 호스트 이름 설정에 대한 자세한 내용은 [콘솔 IP 주소에 호스트 이름 설정](/home/setup-install/dev-kit-settings/setting-a-hostname)을 참고하세요.<br />• 이 옵션을 사용하지 않으면 이전에 [Connect (xbconnect.exe)](/tools/tools-console/commandlinetools/xbconnect)로 설정된 기본 콘솔이 사용됩니다.<br />• *accesskey* 문자열을 사용해 액세스 키가 있는 사람에게만 콘솔 액세스를 제공합니다.<br />• **xbconfig** **accesskey=your-key** 명령을 사용해 액세스 키를 설정한 다음 콘솔을 다시 시작하여 액세스 키를 적용합니다.<br />• 액세스 키로 구성된 콘솔에 액세스하려면 콘솔의 IP 주소 또는 호스트 이름 뒤에 더하기 기호(+)와 액세스 키를 포함합니다.<br />• 기본 콘솔이 [xbconnect](/tools/tools-console/commandlinetools/xbconnect)로 설정될 때 액세스 키가 제공되면 액세스 키는 기본 콘솔의 주소의 일부로 저장됩니다.<br />• 액세스 키에 대한 자세한 내용은 [xbconfig accesskey](/tools/tools-console/commandlinetools/xbconfig)를 참고하세요.<br />• **/X** 뒤에 주소 뒤에 또는 그 자체로 **/title**을 추가하면 실행 중인 exclusive 앱이 보는 파티션 매핑이 사용됩니다. 예를 들어 \*\*/X/title xd:\*\*를 지정하면 실행 중인 exclusive 앱에 표시되는 기본 콘솔의 스크래치 드라이브 파티션에 대한 액세스를 제공합니다. |
| /LC                                       | 로케일 코드를 지정합니다. 기본 로케일 코드를 재정의하는 데 사용됩니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

<a id="remarks" />

## 설명

### 공유 스크래치 드라이브 파티션의 파일 및 디렉터리 대상 지정

D 드라이브 파티션은 이제 시스템과 Game OS 내에서 공유 스크래치 공간으로 액세스할 수 있습니다. 이 공유 드라이브의 타이틀을 복사하려면 **xbcp**(**/x/title** 주소 유무와 관계없이)를 사용해 exclusive 리소스 앱이 사용 중인 드라이브 파티션과 파일에 액세스합니다. 예를 들어 콘솔 스크래치 드라이브에서 모든 파일을 복사하려면 다음 명령 중 하나를 사용합니다.

```text theme={null}
xbcp /X:/Title /S xd:\ c:\
```

또는

```text theme={null}
xbcp /S xd:\ c:\
```

레거시 XBOX One Software Development Kit 타이틀이 실행 중이면 D 드라이브는 시스템의 D 드라이브와는 다른 레거시 TitleScratch 드라이브이지만, 타이틀이 실행 중이 아닐 때 TitleScratch 네트워크 공유를 통해 시스템에서 액세스할 수 있습니다.

<a id="ID4E2E" />

### 앱 컨테이너의 파일 및 디렉터리 대상 지정

exclusive 앱이 실행 중일 때 앱 컨테이너는 읽기 전용이며 `exclusive` 파티션의 G 드라이브에 매핑됩니다. 예를 들어 exclusive 앱이 실행 중일 때 앱 컨테이너에서 data.bin을 복사하려면 다음 명령을 사용합니다.

```text theme={null}
xbcp /S /X:/title XG:\ c:\
```

빌드 시 패키지된 앱은 읽기 전용입니다. 이러한 앱에 대해 파일과 디렉터리를 복사할 수 있지만 추가, 삭제 또는 수정할 수 없습니다.

<a id="ID4EIF" />

## 참고

[명령줄 도구](/tools/tools-console/commandlinetools/commandlinetools)

[XTF 전송 오류](/tools/tools-console/commandlinetools/xtf-transport-errors)

[Connect (xbconnect.exe)](/tools/tools-console/commandlinetools/xbconnect)

[XBOX 개발 키트에 타이틀 배포](/home/setup-install/concepts/deployment)


## Related topics

- [콘솔 개발용 명령줄 도구](/ko/tools/tools-console/commandlinetools/commandlinetools.md)
- [명령줄 도구](/ko/tools/tools-console/commandlinetools/index.md)
- [Visual Studio에서의 프로필 기반 최적화](/ko/tools/tools-console/pgo/pgo_full.md)
- [DirectCapture 개요](/ko/build/core-features/common/game-streaming/game-streaming-directcapture-overview.md)
- [WdCopySearchOptions](/ko/reference/remoting/structs/wdcopysearchoptions.md)