Delete Directory (xbrmdir.exe)
Deletes a directory on a remote console.
Note If an exclusive resource app is not running it is now recommended to use rmdir with the package network share
\\SystemIP\PackagePathinstead of xbrmdir. See Xbox One Neighborhood: Accessing the Console File System from Your PC for more information.
xbrmdir directory [/F] [/U] [/X[:]address[+<accesskey>][/title]]
|
| Option | Description | ||
|---|---|---|---|
| directory | Specifies directory to delete. A fully-qualified path, including the drive letter, must be supplied. See remarks for more information. | ||
| /F | Force deletion of the directory and all files and subdirectories within it. | ||
| /U | Deletes the directory in update mode. The directory will be deleted during the next system boot. | ||
| /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 rmdir with the package network share \\SystemIP\PackagePath instead of xbrmdir. 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 delete the foo directory on the console scratch drive use the SystemScratch network share:
rmdir \\myconsole\SystemScratch\foo\
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 delete the foo directory an installed app on the console, the command would be:
rmdir \\myconsole\MyTitle_1.0.0.0_neutral__8wekyb3d8bbwe\foo
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 delete the foo directory on the exclusive application scratch drive partition use:
rmdir \\myconsole\TitleScratch\foo
Targeting Files and Directories when an Exclusive Resource app is running
If an exclusive resource app is running you must use xbrmdir with the /x/title address to access drive partitions and files being used by the exclusive resource app.
For example, to delete the foo directory in a title’s Game data subdirectory on the console, use:
xbrmdir /X:/title XD:\foo
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 delete the foo directory in an application container while an exclusive app is running:
xbrmdir /X:/title XG:\foo
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 delete the foo directory in the exclusive application scratch drive partition use:
xbrmdir /X:/title XD:\foo