> ## 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)

使用此工具将一个或多个文件复制到远程主机或从远程主机复制。

| Column 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 />• 如果将 **/title** 附加到 **/X**（在地址后面或单独使用），则使用运行中的独占应用所看到的分区映射。例如，指定 **/X/title xd:** 将访问默认主机上运行中独占应用可见的临时驱动器分区。 |
| /LC                                       | 指定区域设置代码，用于覆盖默认的区域设置代码                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

<a id="remarks" />

## 备注

### 在共享临时驱动器分区中定位文件和目录

D 盘分区现在可作为系统和 Game OS 中的共享临时空间访问。若要在此共享驱动器中复制游戏文件，请使用 **xbcp**（使用或不使用 **/x/title** 地址）访问独占资源应用正在使用的驱动器分区和文件。例如，若要从主机临时驱动器复制所有文件，请使用以下任一命令。

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

或

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

如果正在运行传统的 XBOX One Software Development Kit 游戏，则 D 盘是传统的 TitleScratch 驱动器，与系统中的 D 盘不同，但当游戏未运行时可通过系统中的 TitleScratch 网络共享访问。

<a id="ID4E2E" />

### 在应用容器中定位文件和目录

当独占应用运行时，应用容器是只读的，并映射到 `exclusive` 分区中的 G 盘。例如，若要在独占应用运行时从应用容器复制 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

- [面向主机开发的命令行工具](/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令行工具](/zh-CN/tools/tools-console/commandlinetools/index.md)
- [WdRemoteCopy](/zh-CN/reference/remoting/functions/wdremotecopy.md)
- [Profile-guided optimization in Visual Studio](/zh-CN/tools/tools-console/pgo/pgo_full.md)
- [使用 Fiddler 检查 Web 服务调用](/zh-CN/tools/tools-services/live-fiddler-inspect-web-calls.md)