Share via


Storrept reports generate

Applies To: Windows Server 2008, Windows Server 2008 R2

Generates a storage report on demand by generating a new report or by starting a currently scheduled storage report task.

Note

To use this command, you must be logged on as an administrator or a member of the Administrators group.

For examples of how to use this command, see Examples..

Syntax

storrept reports generate /task:<TaskName> [/nowait]

storrept reports generate /report:<Type> /scope:"<Scope>" [nowait] 
   [/format:"<FormatList>"] [/mailto=<EmailList>] [/name:"<Name>"] 
   [/filename:<Pattern>] [/minsize:<Size>[kb|mb|gb]] [/maxage:<Age>] 
   [/minage:<Age>] [/minuse:<Usage>] [/owner:"<OwnerList>"] 
   [/filegroup:"<FgList>"] [/remote:<ComputerName>]

Parameters

Parameter Description

/task:<TaskName>

Generates the storage report associated with the scheduled task TaskName.

Note
For more information about scheduling storage reports tasks, see Storrept reports add.

/nowait

Forces the command to return immediately while the report generation is still in progress.

/report:<Type>

Specifies the report to be generated. Type must be one of the following:

  • DuplicateFiles — Lists files that appear to be duplicates (files with the same size and last-modified time).

  • Export — Includes all the unfiltered data gathered during a file system scan. You can use this data to perform customized storage analysis.

  • FileScreenAudit — Lists file screening events that have occurred on the server for a specified number of days. Use this report to identify users or applications that violate screening policies.

    Important

    Before you schedule a File Screening Audit report, you must enable the recording of file screening activity in the auditing database by using the Dirquota admin options command with the /screenaudit:enabled parameter. You can also enable file screening auditing by using the File Server Resource Manager snap-in (in the main node, click Configure Options ).

  • FilesByFileGroup — Lists files that belong to specified file groups.

  • FilesByOwner — Lists files, grouped by the users who own them.

  • LargeFiles — Lists files that are of a specified size or larger.

  • LeastRecentlyAccessed — Lists files that have not been accessed for a specified number of days.

  • MostRecentlyAccessed — Lists files that have been accessed within a specified number of days.

  • QuotaUsage — Lists quotas for which the quota usage is higher than a specified percentage. Use this report to identify quotas with high usage levels so that appropriate action can be taken.

    Note

    The Quota Usage report includes quotas that were created for volumes and folders in File Server Resource Manager only.

/scope:"<Scope>"

Gathers data for the report from Scope, which is a list of volume and folder paths. Use a pipe character (|) to separate multiple paths, without leaving blank spaces.

/format:"<FormatList>"

Specifies the format or formats in which the reports will be generated. Use a pipe character (|) to separate multiple report formats, without leaving blank spaces. FormatList must be one or more of the values:

  • html — Generates the report in HyperText Markup Language (HTML) format.

  • dhtml — Generates the report in Dynamic HTML (DHTML) format.

  • xml — Generates the report in Extensible Markup Language (XML) format.

  • csv — Generates the report in comma-separated values (CSV) format.

  • txt — Generates the report in text format.

If you do not specify a report format, reports are generated in DHTML and XML formats by default, except for the Export report, whose default format is XML. Also, the Export report can only be generated in CSV or XML format.

/mailto=<EmailList>

Specifies the list of e-mail addresses for the recipients of the reports. Use a semicolon to separate multiple e-mail addresses, without leaving blank spaces. All e-mail addresses must be in the format account@domain.

Note

You can use the [Admin Email] variable instead of an e-mail address to send the reports to the default e-mail addresses for the administrators. To display and configure the default e-mail addresses, use the Dirquota admin options command.

/name:"<Name>"

Specifies a new name for the report. This name will be used for the files and folders that will be created when the report is generated. If you do not specify a report name, the default report name will be used. To see the default name for a scheduled report, use the Storrept reports list command.

/filename:<Pattern>

Specifies the file name pattern for the report type specified in the /report parameter. Only those files that have a file name that matches Pattern will be included in the report. You can use wildcard characters in Pattern (for example, *.exe).

If you do not specify Pattern, the default pattern will be used. To display the default pattern, use the Storrept admin defaults command. The default pattern for each report type will be listed under Filter. If Filter is not listed for a report type, files with any file name pattern are included in that report.

This parameter is valid only when the Type value for the /report parameter is FilesByOwner, LargeFiles, LeastRecentlyAccessed, or MostRecentlyAccessed.

/minsize:<Size>[kb|mb|gb]

Specifies the minimum size of the files that will be listed in the Large Files report. All files of size Size or larger will be listed. By default, Size is denoted in kilobytes (KB), but you can append kb, mb, or gb to specify the unit.

If you do not specify Size, the default minimum file size will be used. To display the default minimum file size, use the Storrept admin defaults command.

This parameter is valid only when the Type value for the /add-report parameter is LargeFiles.

/maxage:<Age>

Specifies the maximum number of days since a file was last accessed. All files that were accessed Age days ago or more recently will be included in the Most Recently Accessed Files report.

If you do not specify Age, the default maximum number of days will be used. To display the default maximum number of days, use the Storrept admin defaults command.

This parameter is valid only when the Type value for the /report parameter is MostRecentlyAccessed.

/minage:<Age>

Specifies the minimum number of days since a file was last accessed or since a file screening event occurred. All files that were accessed Age days ago or before will be included in the Least Recently Accessed Files report. All file screening audit events that happened Age days ago or before will be included in the File Screening Audit report. To specify all file screening events, set Age to 0 (zero).

If you do not specify Age, the default minimum number of days will be used. To display the default minimum number of days, use the Storrept admin defaults command.

This parameter is valid only when the Type value for the /report parameter is either LeastRecentlyAccessed or FileScreenAudit.

/minuse:<Usage>

Specifies the minimum percentage of quota usage of the quotas that will be listed in the Quota Usage report. To specify all quotas, set Usage to 0 (zero).

If you do not specify Usage, the default minimum percentage of quota usage will be used. To display the default minimum percentage of quota usage, use the Storrept admin defaults command.

This parameter is valid only when the Type value for the /report parameter is QuotaUsage.

/owner:"<OwnerList>"

Specifies the list of file owners for the File Screen Audit report or the Files by Owner report. OwnerList can be a list of one or more user names separated by a pipe character (|), enclosed in quotation marks. To specify all owners, set FgList to "".

If you do not specify OwnerList, the default list of owners will be included in the report. To display the default list of owners, use the Storrept admin defaults command.

This parameter is valid only when the Type value for the /report parameter is either FileScreenAudit or FilesByOwner.

/filegroup:"<FgList>"]

Specifies a list of file groups for the Files by File Group report. FgList is a list of one or more file group names separated by a pipe character (|), enclosed in quotation marks. To display a list of file groups, use the Filescrn filegroup list command. To specify all file groups, set FgList to "".

If you do not specify a list of file groups, the default file groups for the Files by File Group report will be included. To display the list of default file groups, use the Storrept admin defaults command.

This parameter is valid only when the Type value for the /report parameter is FilesByFileGroup

/remote:<ComputerName>

Performs the operation on the remote computer ComputerName.

Remarks

  • The shortest sequence of characters that uniquely identifies a parameter can be used as an abbreviation. For example, the following two commands are equivalent:

    storrept r g /t:reporttask /n
    storrept reports generate /task:reporttask /nowait
    
  • To perform operations on a remote computer by using the **/remote:**ComputerName parameter:

    • You must be logged on with a domain account that is a member of the Administrators group on both the local computer and the remote computer.

    • The remote computer must be running Windows Server 2008, and File Server Resource Manager must be installed.

    • The Remote File Server Resource Manager Management exception on the remote computer must be enabled. You enable this exception by using Windows Firewall in Control Panel.

Examples.

  • To generate the storage report associated with the FSRMReport task configured on the local computer, type:

    storrept reports generate /task:FSRMreport
    
  • To generate a Quota Usage report that lists only those quotas that exceed or match 75 percent of the quota limit on drives C: and E:, and have that report saved both in HTML and text format, type:

    storrept reports generate /report:quotausage /scope:"c:\|e:\" /minuse:75 /format:"html|txt"
    

Additional references

Command-Line Syntax Key

Storrept reports