File Delete (xbdel.exe)
Deletes one or more files from a remote console.
Note If an exclusive resource app is not running, it is now recommended to use del with the package network share
\\SystemIP\PackagePathinstead of xbdel. See Xbox One Neighborhood: Accessing the Console File System from Your PC for more information.
xbdel file_name [/A[ [:]attributes] ] [/S[ [:]levels] ] [/U] [/X[:]address[+<accesskey>][/title]]
|
| Option | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| file_name | Specifies the file or files to delete. A fully-qualified path, including the drive letter, must be supplied. Wildcards in file_name are supported. The drive letter in file_name must be prefixed with X to specify that the drive is on the remote console. | ||||||||||||
| /A[ [:]attributes] | Deletes files with the specified attributes.
| ||||||||||||
| /S[ [:]levels] | Deletes files in the directory specified by file_name and all subdirectories down to a depth specified by levels, an integer. For example, xbdel /S:1 will process only the specified directory and subdirectories one level below it. If /S is specified, but levels is not, all subdirectories will be processed. | ||||||||||||
| /U | Deletes files in update mode. Files will be flagged for deletion 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 del with the package network share \\SystemIP\PackagePath instead of xbdel. 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 all the text files on the console scratch drive use the SystemScratch network share:
del \\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 delete all the text files for an installed app on the console, the command would be:
del \\myconsole\MyTitle_1.0.0.0_neutral__8wekyb3d8bbwe\*.txt
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 all the text files in the exclusive application scratch drive partition use:
del \\myconsole\TitleScratch\*.txt
Targeting Files and Directories when an Exclusive Resource app is running
If an exclusive resource app is running you must use xbdel with the /x/title address to access drive partitions and files being used by the exclusive resource app.
For example, to delete all the text files in a title’s data subdirectory on the console, use:
xbdel /X:/title XD:\data\*.txt
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 all the text files in an application container while an exclusive app is running:
xbdel /X:/title XG:\*.txt
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 all the text files in the exclusive application scratch drive partition use:
xbdel /X:/title XD:\*.txt