Openfiles |
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
- 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. |
Examples
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 |
|
|
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. |
|
To disable the Maintain Objects List global flag, type:
|
|
openfiles /local off |
|
