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

# 目录 (xbdir.exe)

> 目录 (xbdir.exe)

使用此工具显示远程主机上的文件和子目录列表。

| 列 1 |
| - |
| \*\*xbdir \*\**filename* \[/A\[ \[:]*attributes*] ] \[/B] \[/C] \[/O\[ \[:]*sortorder*] ] \[/S\[ \[:]*levels*] ] \[/T\[ \[:]*timefield*] ] \[/X\[:]*address\[+\<accesskey>]\[/title]*] |

| 选项 | 说明 |
| - | - |
| *filename* | 要列出的驱动器、目录或文件。必须提供完全限定的路径,包括驱动器盘符。文件名中支持通配符。*filename* 中的驱动器盘符必须以 X 作为前缀,以指定该驱动器位于远程主机上。 |
| /A\[ \[:]*attributes*] | 显示具有指定属性的文件。如果未指定属性,则显示所有文件。取值如下所示。 **H** 隐藏文件 **R** 只读文件 **S** 系统文件 **A** 准备好归档的文件 **-** 取反前缀;显示*不*具有指定标志的文件 |
| /B | 使用简洁格式;仅显示文件名。 |
| /C | 在文件大小中显示千位分隔符。这是默认值。若要禁用显示分隔符,请使用 **/-C**。 |
| /O\[ \[:]*sortorder*] | 按排序顺序显示文件。取值如下所示。 **D** 按日期和时间,最早的在前 **E** 按扩展名,按字母顺序 **N** 按名称,按字母顺序 **S** 按大小,最小的在前 **-** 反转排序顺序的取反前缀 |
| /S\[ \[:]*levels*] | 显示指定目录及其所有子目录中的文件。若要指定子目录递归深度,请使用可选整数 *levels*。例如,**xbdir /S:1** 仅处理指定目录及其下一级子目录。如果指定了 **/S** 但未指定 *levels*,则处理所有子目录。 |
| /T\[ \[:]*timefield*] | 要显示或用于排序的时间字段。取值如下所示。 **C** 创建时间 **A** 上次访问时间 **W** 上次写入时间 |
| /X\[:]*address\[+\<accesskey>]* | - 使用此选项可指定目标主机的主机名或地址(在主机上显示为 **Tools IP**),而不更改默认主机。有关为主机设置主机名的详细信息,请参阅[为主机 IP 地址设置主机名](/zh-CN/home/setup-install/dev-kit-settings/setting-a-hostname.md)。 - 如果不使用此选项,则使用默认主机(先前由 [Connect (xbconnect.exe)](/zh-CN/tools/tools-console/commandlinetools/xbconnect.md) 设置)。 - 使用 *accesskey* 字符串仅向持有访问密钥的人员提供主机访问权限。 - 通过命令 **xbconfig** **accesskey=your-key** 设置访问密钥,然后重启主机使访问密钥生效。 - 若要访问配置了访问密钥的主机,请在主机的 IP 地址或主机名后加上加号 (+) 和访问密钥。 - 如果在通过 [xbconnect](/zh-CN/tools/tools-console/commandlinetools/xbconnect.md) 设置默认主机时提供了访问密钥,则该访问密钥将作为默认主机地址的一部分存储。 - 有关访问密钥的详细信息,请参阅 [xbconfig accesskey](/zh-CN/tools/tools-console/commandlinetools/xbconfig.md)。 |
| /LC | 指定区域设置代码。用于覆盖默认的区域设置代码。 |

## 备注

### 定位共享暂存驱动器分区中的文件和目录

D 盘分区现在可作为共享暂存空间供系统访问,也可从 Game OS 中访问。若要列出此共享驱动器中的目录,请使用 **xbdir**(可带或不带 **/x/title** 地址)访问独占资源应用正在使用的驱动器分区和文件。例如,若要查看主机上标题根暂存目录中的所有文本文件,请使用以下命令之一。

```
xbdir /X:/title XD:\*.txt  
```

或

```
xbdir XD:\*.txt  
```

如果正在运行旧版 XBOX One 软件开发工具包标题,则 D 盘为旧版 TitleScratch 驱动器,它与系统中的 D 盘不同,但在标题未运行时可在系统中通过 TitleScratch 网络共享访问。

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

独占应用运行时,应用容器为只读,并映射到 `exclusive` 分区中的 G 盘。例如,若要在独占应用运行时列出应用容器中的文件,请使用以下命令。

```
xbdir /X:/title XG:\ 
```

在构建时打包的应用为只读。可以为这些应用复制文件和目录,但不能添加、删除或修改。

## 另请参阅

[命令行工具](/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)

[XTF 传输错误](/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)

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


## Related topics

- [Connect (xbconnect.exe)](/zh-CN/tools/tools-console/commandlinetools/xbconnect.md)
- [面向主机开发的命令行工具](/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令行工具](/zh-CN/tools/tools-console/commandlinetools/index.md)
- [删除目录 (xbrmdir.exe)](/zh-CN/tools/tools-console/commandlinetools/xbrmdir.md)
- [创建目录 (xbmkdir.exe)](/zh-CN/tools/tools-console/commandlinetools/xbmkdir.md)
