Exporting File and Directory Information

 

Exporting Files and Directories

The file and directory exporting options use user-defined templates similar to those used for Registry, WMI, and Active Directory exporting.  To define a file/directory exporting template:

  1. Select Configuration->Export Properties, and double-click the File/Directory export option.  

  2. Click the New... button to create a new file/directory export template.

  3. Check the Enabled checkbox to enable the new template and supply a descriptive name for the template.

  4. Provide an output file and path to send the exported information to.

  5. Click the Customize Output Columns button to customize the output fields.

  6. Set file/directory export options (see below for details) and run the export.

Setting File Directory Export Options

Setting Shared Directory Paths

All file and directory exporting require one or more shared directory paths to be specified.  For each computer that Exporter Pro is processing, each specified shared directory path will be checked for any files or directories that match the specified file or file filters (see 'Setting File Name Filters' below).  

To add a shared directory path, click the Shared Directory Path->Add... button.  Shared directory paths can be specified either by directly entering the share name, or by allowing Exporter Pro to retrieve all shares matching a particular share type.

Retrieving All Shares

To have Exporter Pro scan all shares on a computer, select the Retrieve all shares matching specified type: option.  When this option is selected, one or more of the share type checkboxes can be selected.  

Using a Specific Share Name Path

In addition to (or instead of) retrieving all shares, one or more specific paths can be specified.  Exporter Pro also supports searching for shares by entry of a wildcard in the share name.  Examples of valid shared directory paths:

filedata
user*
*_sales
sales\november

To illustrate the techniques involved, assume that the current computer that Exporter Pro is named "FINANCE".  Using the share name examples above, Exporter Pro would search these example directories for files:

\\FINANCE\filedata
\\FINANCE\user_JOE
\\FINANCE\user_MARY
\\FINANCE\JAN_sales
\\FINANCE\FEB_sales
\\FINANCE\sales\november

Important Notes:

You can use BOTH the 'retrieve all shares' option and any combination of specific share paths if desired.  Remember, however, that the administrative shares (C$, D$, etc.) generally include all of the disks on a computer and therefore all of the files and directories.

Separate multiple share directory paths with the ' | ' symbol.

Setting Directory Scan Options

To scan only the root of the shared directory paths, select the Scan top-level of path only (no subdirectories) option.  To scan the specified directory path(s) and all subdirectories, select the Scan top-level of path and all subdirectories option.

Setting File Name Filters

The File Name Filters option is used to specify the list of files and or file/directory wildcards to search. If left blank, Exporter Pro will default to '*.*' (all files and directories).  Any combination of file or directory names, including the '*' wildcard, can be used to specify file name filters.  For example:

sales.xls
sales.doc
inventory.*
data*.*
*.rpt

Setting Other Options

Exporting Only Directory Information - To only export file directories entries, check the Output Directory Information Only box on the File/Directory Export Template Properties.  See the 'Exporting Directory Size Information' topic below for more information on directory exporting behavior.  

Exporting Directory Size Information - To export the file sizes of directories, add the Dir Files (bytes) output field to the export output columns.  The "Dir Files" output field will contain the total size of any files that match the File Name Filters for any directory entry.  Note that when this column is added to the output, ALL directory entries will be exported, even if a directory does not have any files matching any of the file name filters.  If the directory does not contain any files matching any of the file filters, the directory size will be listed as zero (0).

Important Notes:

To get the size of all files in a directory, use *.* for the file name filter (or leave it blank).

The 'size' of the files in a directory only includes files in the directory itself, and NOT any subdirectories under the directory.

Exporter Pro will report the sizes of the matching files in directories that are in the shared directory path(s), even if the "Scan top-level of path only (no subdirectories) is selected. However, subdirectories under any of these directories will NOT be reported, unless the 'Scan top-level of path and all subdirectories' option is selected.  For example, if the shared directory path named 'Data' is set as one of the Shared Directory Paths to scan, and the 'Data' directory contains subdirectories named "Sue" and "Robert", the size of any matching files in the Sue/Robert directories will be exported.

Exporting File and Directory Security

To export file or directory security, first configure and enable one or more file/directory exporting templates.  The file/directory security exporting option uses the file/directory exporting template as a mechanism to control which file entries to process.

To enable file/directory security exporting, select Configuration->Export Properties->Security Access, and enable the File and Directories option.

Directory Security Inheritance Values

Windows 2000 and later Windows versions introduce complex security options for controlling the inheritance of security settings for files and directories.  Use the table below to help interpret the settings for directory inheritance security, which has been reproduced from MSDN.  The term 'ACE' below refers to an 'access control entry', such as a user or group's security assignment, ie "Sales_Group : Full Control"

CONTAINER_INHERIT - Container objects, such as directories, inherit the ACE as an effective ACE. The inherited ACE is inheritable unless the NO_PROPAGATE_INHERIT flag is also set.

INHERIT_ONLY - Indicates an inherit-only ACE, which does not control access to the object to which it is attached. If this flag is not set, the ACE is an effective ACE which controls access to the object to which it is attached. Both effective and inherit-only ACEs can be inherited depending on the state of the other inheritance flags.

INHERITED - Indicates that the ACE was inherited. The system sets this flag when it propagates an inherited ACE to a child object. Windows NT:  Not supported.

NO_PROPAGATE_INHERIT - If the ACE is inherited by a child object, the system clears the OBJECT_INHERIT and CONTAINER_INHERIT flags in the inherited ACE. This prevents the ACE from being inherited by subsequent generations of objects.

OBJECT_INHERIT - Non container child objects (ie files), inherit the ACE as an effective ACE. For child objects that are containers, such as directories, the ACE is inherited as an inherit-only ACE unless the NO_PROPAGATE_INHERIT flag is also set.