Applies To: Windows Vista,Windows Server 2008

Enables an administrator to query, display, or disconnect files and directories that have been opened on a system. Also enables or disables the system Maintain Objects List global flag.

This topic includes information about the following commands:

openfiles /disconnect

Enables an administrator to disconnect files and folders that have been opened remotely through a shared folder.
Syntax
 Copy Code
openfiles /disconnect [/s <System> [/u [<Domain>\]<UserName> [/p [<Password>]]]] {[/id <OpenFileID>] | [/a <AccessedBy>] | [/o {read | write | read/write}]} [/op <OpenFile>]
Parameters

Parameter Description

/s <System>

Specifies the remote system to connect to (by name or IP address). Do not use backslashes. If you do not use the /s option, the command is executed on the local computer by default. This parameter applies to all files and folders that are specified in the command.

/u [<Domain>\]<UserName>

Executes the command by using the permissions of the specified user account. If you do not use the /u option, system permissions are used by default.

/p [<Password>]

Specifies the password of the user account that is specified in the /u option. If you do not use the /p option, a password prompt appears when the command is executed.

/id <OpenFileID>

Disconnects open files by the specified file ID. The wildcard character (*) can be used with this parameter.

Note
You can use the openfiles /query command to find the file ID.

/a <AccessedBy>

Disconnects all open files associated with the user name that is specified in the AccessedBy parameter. The wildcard character (*) can be used with this parameter.

/o {read | write | read/write}

Disconnects all open files with the specified open mode value. Valid values are Read, Write, or Read/Write. The wildcard character (*) can be used with this parameter.

/op <OpenFile>

Disconnects all open file connections that are created by a specific open file name. The wildcard character (*) can be used with this parameter.

/?

Displays help at the command prompt.

Examples

To disconnect all open files with the file ID 26843578, type:

 Copy Code
openfiles /disconnect /id 26843578

To disconnect all open files and directories accessed by the user "hiropln," type:

 Copy Code
openfiles /disconnect /a hiropln

To disconnect all open files and directories with read/write mode, type:

 Copy Code
openfiles /disconnect /o read/write

To disconnect the directory with the Open File name "C:\TestShare\", regardless of who is accessing it, type:

 Copy Code
openfiles /disconnect /a * /op "c:\testshare\"

To disconnect all open files on the remote computer "srvmain" that are being accessed by the user "hiropln," regardless of their ID, type:

 Copy Code
openfiles /disconnect /s srvmain /u maindom\hiropln /id *

openfiles /query

Queries and displays all open files.
Syntax
 Copy Code
openfiles /query [/s <System> [/u [<Domain>\]<UserName> [/p [<Password>]]]] [/fo {TABLE | LIST | CSV}] [/nh] [/v]
Parameters

Parameter Description

/s <System>

Specifies the remote system to connect to (by name or IP address). Do not use backslashes. If you do not use the /s option, the command is executed on the local computer by default. This parameter applies to all files and folders that are specified in the command.

/u [<Domain>\]<UserName>

Executes the command by using the permissions of the specified user account. If you do not use the /u option, system permissions are used by default.

/p [<Password>]

Specifies the password of the user account that is specified in the /u option. If you do not use the /p option, a password prompt appears when the command is executed.

[/fo {TABLE | LIST | CSV}]

Displays the output in the specified format. Valid values for Format are:

TABLE: Displays output in a table.

LIST: Displays output in a list.

CSV: Displays output in Comma Separated Values format.

/nh

Suppresses column header in the output. Valid only when the /fo parameter is set to TABLE or CSV.

/v

Specifies that detailed information be displayed in the output.

/?

Displays help at the command prompt.

Examples

To query and display all open files, type:

 Copy Code
openfiles /query

To query and display all open files in table format without headers, type:

 Copy Code
openfiles /query /fo table /nh

To query and display all open files in list format with detailed information, type:

 Copy Code
openfiles /query /fo list /v

To query and display all open files on the remote system "srvmain" by using the credentials for the user "hiropln" on the "maindom" domain, type:

 Copy Code
openfiles /query /s srvmain /u maindom\hiropln /p p@ssW23
Note
In this example, the password is supplied on the command line. To prevent displaying the password, leave out the /p option. You will be prompted for the password, which will not be echoed to the screen.

openfiles /local

Enables or disables the system Maintain Objects List global flag. If used without parameters, openfiles /local displays the current status of the Maintain Objects List global flag.
Syntax
 Copy Code
openfiles /local [on | off]
Parameters

Parameter Description

[on | off]

Enables or disables the system Maintain Objects List global flag, which tracks local file handles.

/?

Displays help at the command prompt.

Remarks
  • Enabling the Maintain Objects List global flag may slow down your system.

  • Changes made by using the on or off option do not take effect until you restart the system.

Examples

To check the current status of the Maintain Objects List global flag, type:

 Copy Code
openfiles /local

By default, the Maintain Objects List global flag is disabled, and the following output is displayed:

 Copy Code
INFO: The system global flag 'maintain objects list' is currently disabled.

To enable the Maintain Objects List global flag, type:

 Copy Code
openfiles /local on

The following message is displayed when the global flag is enabled:

 Copy Code
SUCCESS: The system global flag 'maintain objects list' is enabled.
         This will take effect after the system is restarted.

To disable the Maintain Objects List global flag, type:

 Copy Code
openfiles /local off

Additional references

Command-Line Syntax Key