Openfiles
Applies To: Windows Server 2008, Windows Vista
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
openfiles /query
openfiles /local
openfiles /disconnect
Enables an administrator to disconnect files and folders that have been opened remotely through a shared folder.
Syntax
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.
|
||
/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 modevalue. 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. |
.gif)
NoteExamples
To disconnect all open files with the file ID 26843578, type:
openfiles /disconnect /id 26843578
To disconnect all open files and directories accessed by the user "hiropln," type:
openfiles /disconnect /a hiropln
To disconnect all open files and directories with read/write mode, type:
openfiles /disconnect /o read/write
To disconnect the directory with the Open File name "C:\TestShare\", regardless of who is accessing it, type:
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:
openfiles /disconnect /s srvmain /u maindom\hiropln /id *
openfiles /query
Queries and displays all open files.
Syntax
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:
openfiles /query
To query and display all open files in table format without headers, type:
openfiles /query /fo table /nh
To query and display all open files in list format with detailed information, type:
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:
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
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:
openfiles /local
By default, the Maintain Objects List global flag is disabled, and the following output is displayed:
INFO: The system global flag 'maintain objects list' is currently disabled.
To enable the Maintain Objects List global flag, type:
openfiles /local on
The following message is displayed when the global flag is enabled:
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:
openfiles /local off