fsutil 8dot3name
Queries or changes the settings for short name (8dot3 name) behavior, which includes:
Querying the current setting for the short name behavior.
Scanning the specified directory path for registry keys that might be impacted if short names were stripped from the specified directory path.
Changing the setting that controls the short name behavior. This setting can be applied to a specified volume or to the default volume setting.
Removing the short names for all files within a directory.
Important
Permanently removing 8dot3 file names and not modifying registry keys that point to the 8dot3 file names may lead to unexpected application failures, including the inability to uninstall an application. It is recommended you first back up your directory or volume before you attempt to remove 8dot3 file names.
Syntax
fsutil 8dot3name [query] [<volumepath>]
fsutil 8dot3name [scan] [/s] [/l [<log file>] ] [/v] <directorypath>
fsutil 8dot3name [set] { <defaultvalue> | <volumepath> {1|0}}
fsutil 8dot3name [strip] [/t] [/s] [/f] [/l [<log file.] ] [/v] <directorypath>
Parameters
| Parameter | Description |
|---|---|
query [<volumepath>] |
Queries the file system for the state of the 8dot3 short name creation behavior. If a volumepath isn't specified as a parameter, the default 8dot3name creation behavior setting for all volumes is displayed. |
scan <directorypath> |
Scans the files that are located in the specified directorypath for registry keys that might be impacted if 8dot3 short names were stripped from the file names. |
set {<defaultvalue> \| <volumepath>} |
Changes the file system behavior for 8dot3 name creation in the following instances:
|
strip <directorypath> |
Removes the 8dot3 file names for all files that are located in the specified directorypath. The 8dot3 file name is not removed for any files where the directorypath combined with the file name contains more than 260 characters. This command lists, but does not modify the registry keys that point to the files that had 8dot3 file names permanently removed. |
<volumepath> |
Specifies the drive name followed by a colon or the GUID in the format volume{GUID}. |
| /f | Specifies that all files that are located in the specified directorypath have the 8dot3 file names removed even if there are registry keys that point to files using the 8dot3 file name. In this case, the operation removes the 8dot3 file names, but does not modify any registry keys that point to the files that are using the 8dot3 file names. Warning: It's recommended that you back up your directory or volume prior to using the /f parameter because it may lead to unexpected application failures, including the inability to uninstall programs. |
/l [<log file>] |
Specifies a log file where information is written. If the /l parameter isn't specified, all information is written to the default log file: |
| /s | Specifies that the operation should be applied to the subdirectories of the specified directorypath. |
| /t | Specifies that the removal of 8dot3 file names should be run in test mode. All operations except the actual removal of the 8dot3 file names are performed. You can use test mode to discover which registry keys point to files that use the 8dot3 file names. |
| /v | Specifies that all information that is written to the log file is also displayed on the command-line. |
Examples
To query for the disable 8dot3 name behavior for a disk volume that is specified with the GUID, {928842df-5a01-11de-a85c-806e6f6e6963}, type:
fsutil 8dot3name query volume{928842df-5a01-11de-a85c-806e6f6e6963}
You can also query the 8dot3 name behavior by using the behavior subcommand.
To remove 8dot3 file names in the D:\MyData directory and all subdirectories, while writing the information to the log file that is specified as mylogfile.log, type:
fsutil 8dot3name strip /l mylogfile.log /s d:\MyData