Fsutil 8dot3name |
Applies To: Windows Server 2008 R2,Windows 7
Queries or changes the settings for short name (8dot3 name) behavior, which include:
- Query the current setting for the short name behavior
- Scan the specified directory path for registry keys that might be impacted if short names were stripped from the specified directory path
- Change the setting that controls the short name behavior. This setting can be applied to a specified volume or to the default volume setting.
- Remove the short names for all files within a directory
For examples of how to use this command, see Examples.
Syntax
Copy Code |
|
fsutil 8dot3name [query] [<VolumePath>] |
Parameters
Parameter |
Description |
||
query [<VolumePath>] |
Queries the file system for the state of the 8dot3 short name creation behavior. If a VolumePath is not 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. For more information about the effects of permanently removing the 8dot3 file names from files, see Remarks. |
||
<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 will 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.
|
||
/l [<log file>] |
Specifies a log file where information will be written. If the /l parameter is not specified, all information is written to the default log file: %temp%\8dot3_removal_log@(GMT YYYY-MM-DD HH-MM-SS).log |
||
/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. |
Remarks
- 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.
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:
Copy Code |
|
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:
Copy Code |
|
fsutil 8dot3name scan /l mylogfile.log /s d:\MyData |