Directory (xbdir.exe)
Displays a list of files and subdirectories that are on a remote console.
Note If an exclusive resource app is not running it is now recommended to use dir with the package network share
\\SystemIP\PackagePathinstead of xbdir. See Xbox One Neighborhood: Accessing the Console File System from Your PC for more information.
xbdir filename [/A[ [:]attributes] ] [/B] [/C] [/O[ [:]sortorder] ] [/S[ [:]levels] ] [/T[ [:]timefield] ] [/X[:]address[+<accesskey>][/title]]
|
| Option | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| filename | Specifies the drive, directory, or files to list. A fully-qualified path, including the drive letter, must be supplied. Wildcards in the file name are supported. The drive letter in filename must be prefixed with an X, specifying that the drive is on the remote console. | ||||||||||||
| /A[ [:]attributes] | Displays files with the specified attributes. If no attributes are specified, displays all files.
| ||||||||||||
| /B | Uses bare format (only filenames are displayed). | ||||||||||||
| /C | Display the thousands separator in file sizes. This is the default. Use /-C to disable display of the separator. | ||||||||||||
| /O[ [:]sortorder] | Display files in sorted order.
| ||||||||||||
| /S[ [:]levels] | Display files in specified directory and all subdirectories. levels is an optional integer that specifies the subdirectory recursion depth. For example, xbdir /S:1 will only process the specified directory and subdirectories 1 level below it. If /S is specified, but levels is not, all subdirectories will be included. | ||||||||||||
| /T[ [:]timefield] | Specifies the time field to display or use for sorting.
| ||||||||||||
| /X[:]address[+<accesskey>][/title] | Specifies the host name or address (shown as Tools IP on the console) of a targeted console, but does not change the default console. For information about setting a host name for a console, see Setting a Hostname for the Console IP Address.If you do not use this option, the default console (previously set by Connect (xbconnect.exe)) is used.Accesskey is a string that you can use to restrict access to a console to only those people who know the access key. Set the access key by using the command xbconfig accesskey=your-key; then, restart your console to make the access key effective. To access a console that is configured with an access key, you must include a plus sign (+) and the access key after the IP address or host name of the console. For more information about access keys, see xbconfig accesskey.
|
Note Remarks
Executable files or .dll files which are simply copied, not deployed, will not be registered, and will therefore not be loadable. Use xbapp deploy or Visual Studio auto-deploy to copy application executable files to a development kit. xbcp can be used to copy other files once an executable is registered/deployed on the development kit.
Targeting Files and Directories when an Exclusive Resource app is not running
If an exclusive resource app is not running it is now recommended to use dir with the package network share \\SystemIP\PackagePath instead of xbdir. See Xbox One Neighborhood: Accessing the Console File System from Your PC for more information. The file system on the console is exposed as a set of network shares.
For example, to list all of the text files on the console scratch drive use the SystemScratch network share:
dir \\myconsole\SystemScratch\*.txt
Targeting Files and Directories in an Application Container
Applications are packaged into containers at build or deployment. To interact with the files of an app once it is installed on the console, use the network share that is the full package name of your application.
For example, to list the files of an installed app on the console, the command would be:
dir \\myconsole\MyTitle_1.0.0.0_neutral__8wekyb3d8bbwe\
Targeting Files and Directories in the Shared Scratch Drive Partition
The D: drive partition is accessible as a scratch space when an exclusive app is running. To access the D: drive partition when an exclusive app is not running use the TitleScratch network share.
For example, to list the files on the exclusive application scratch drive partition use:
dir \\myconsole\TitleScratch\
Targeting Files and Directories when an Exclusive Resource app is running
If an exclusive resource app is running you must use xbdir with the /x/title address to access drive partitions and files being used by the exclusive resource app.
For example, to list all of the files in a title’s Game data subdirectory on the console, use:
xbdir /X:/title "XD:\Game data"
The quotes are not necessary in the command if the directory names do not contain spaces.
Targeting Files and Directories in an Application Container
While an exclusive app is running, the application container is mapped to the G: drive in the exclusive partition and is read only.
For example, to list the files in an application container while an exclusive app is running:
xbdir /X:/title XG:\
Targeting Files and Directories in the Shared Scratch Drive Partition
The D: drive partition is accessible as a scratch space when an exclusive app is running. To access the D: drive partition with a remote console tool while an exclusive app is running, specify XD: as the remote drive and use address the /x/title address.
For example, to list the files in the exclusive application scratch drive partition use:
xbdir /X:/title XD:\