Set-Fsrm
Syntax
Set-FsrmSetting
[-InputObject <CimInstance[]>]
[-SmtpServer <String>]
[-FromEmailAddress <String>]
[-AdminEmailAddress <String>]
[-EmailNotificationLimit <Int32>]
[-EventNotificationLimit <Int32>]
[-CommandNotificationLimit <Int32>]
[-ReportNotificationLimit <Int32>]
[-ReportLimitMaxFile <Int32>]
[-ReportLimitMaxFileGroup <Int32>]
[-ReportLimitMaxOwner <Int32>]
[-ReportLimitMaxFilesPerFileGroup <Int32>]
[-ReportLimitMaxFilesPerOwner <Int32>]
[-ReportLimitMaxFilesPerDuplicateGroup <Int32>]
[-ReportLimitMaxDuplicateGroup <Int32>]
[-ReportLimitMaxQuota <Int32>]
[-ReportLimitMaxFileScreenEvent <Int32>]
[-ReportLimitMaxPropertyValue <Int32>]
[-ReportLimitMaxFilesPerPropertyValue <Int32>]
[-ReportLocationIncident <String>]
[-ReportLocationScheduled <String>]
[-ReportLocationOnDemand <String>]
[-ReportFileScreenAuditDaysSince <Int32>]
[-ReportFileScreenAuditUser <String[]>]
[-ReportFileGroupIncluded <String[]>]
[-ReportFileOwnerUser <String[]>]
[-ReportFileOwnerFilePattern <String>]
[-ReportPropertyName <String>]
[-ReportPropertyFilePattern <String>]
[-ReportLargeFileMinimum <UInt64>]
[-ReportLargeFilePattern <String>]
[-ReportLeastAccessedMinimum <Int32>]
[-ReportLeastAccessedFilePattern <String>]
[-ReportMostAccessedMaximum <Int32>]
[-ReportMostAccessedFilePattern <String>]
[-ReportQuotaMinimumUsage <Int32>]
[-ReportFileScreenAuditEnable]
[-ReportClassificationFormat <FsrmReportClassificationFormatEnum[]>]
[-ReportClassificationMailTo <String>]
[-ReportClassificationLog <FsrmReportClassificationLogEnum[]>]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
The Set-FsrmSetting cmdlet changes global File Server Resource Manager (FSRM) settings for the computer.
Examples
Example 1: Change the FSRM setting for administrator email address
PS C:\> Set-FsrmSetting -AdminEmailAddress "john@contoso.com"This command specifies the address "john@contoso.com" for the recipient of email that the server sends to the administrator.
Example 2: Change the FSRM setting for command notification limit
PS C:\> Set-FsrmSetting -CommandNotificationLimit 80This command specifies 80 as the minimum number of seconds between individual running events of a command-type notification.
Example 3: Change the FSRM setting for report classification format
PS C:\> Set-FsrmSetting -ReportClassificationFormat @('Xml')This command specifies XML as the format of classification reports that the server generates.
Example 4: Change the FSRM setting for report classification log type
PS C:\> Set-FsrmSetting -ReportClassificationLog @('ErrorsInSystemLog')This command specifies ErrorsInSystemLog as the type of log that the File Classification Infrastructure generates during classification.
Example 5: Change the FSRM settings for large file reports and quota usage reports
PS C:\> Set-FsrmSetting -ReportLargeFilePattern '*' -ReportLimitMaxQuota 100This command specifies the wildcard character ( ) to indicate that the large file report includes any files that match the value set for the **ReportLargeFileMinimum * parameter. The command also specifies that 100 is the maximum number of quotas to include in a quota usage report.
Example 6: Change the FSRM setting for the SMTP server and file by owner reports
PS C:\> Set-FsrmSetting -SmtpServer "10.121.24.132" -ReportFileOwnerFilePattern "*.xml"This command specifies 10.121.24.132 as the IP address of the SMTP server that FSRM uses to send email. The command also specifies *.XML as the file pattern to match for the file by owner report.
Optional Parameters
Specifies a semicolon-separated list of email addresses for the recipients of any email that the server sends to the administrator.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
The cmdlet immediately returns an object that represents the job and then displays the command prompt.
You can continue to work in the session while the job completes.
To manage the job, use the
*-Job
cmdlets.
To get the job results, use the
Receive-Job
cmdlet.
For more information about Windows PowerShell background jobs, see about_Jobs .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.
| Type: | CimSession[] |
| Aliases: | Session |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum number of seconds between individual running events of a command-type notification. If multiple command notifications occur, the server runs the command notification only if at least this amount of time has passed since the server last performed this action.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum number of seconds between individual running events of an email-type notification. If multiple command notifications occur, the server runs the command notification only if at least this amount of time has passed since the server last performed this action.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum number of seconds between individual running events of an event-type notification. If multiple command notifications occur, the server runs the command notification only if at least this amount of time has passed since the server last performed this action.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the default email address from which FSRM sends email messages.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.
| Type: | CimInstance[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True (ByValue) |
| Accept wildcard characters: | False |
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies an array of formats of classification reports that the server generates. The acceptable values for this parameter are:
- DHTML
- HTML
- XML
- CSV
- Text
| Type: | FsrmReportClassificationFormatEnum[] |
| Parameter Sets: | DHtml, Html, Text, Csv, Xml |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies an array of types of logs that the File Classification Infrastructure can generate during classification. The acceptable values for this parameter are:
- None
- ClassificationsInLogFile
- ErrorsInLogFile
- ClassificationsInSystemLog
- ErrorsInSystemLog
| Type: | FsrmReportClassificationLogEnum[] |
| Parameter Sets: | ClassificationsInLogFile, ErrorsInLogFile, ClassificationsInSystemLog, ErrorsInSystemLog |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a semicolon-separated list of email addresses. The server sends the classification reports to the email addresses after a scheduled classification is complete.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies an array of names of file groups to include in the report. Each string must be the name of a valid file group.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a file pattern string that indicates which files to include in the file by owner report. You can use the wildcard characters * and ? in the string.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies an array of users, in Domain\User format, to include files for in the file by owner report. The default value is an empty list, which indicates all users.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum number of days since the audit event to include in the report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Indicates that file screen auditing is enabled.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies an array of user email addresses to include audit events for. The default value is an empty list, which indicates all users.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum file size to include in the large file report.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a string of files to include in the large file report. You can use the wildcard characters * and ? in the string.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a string of files to include in the least frequently accessed report. You can use the wildcard characters * and ? in the string.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum number of days since the report was last accessed, to include in the least frequently accessed report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of groups of duplicate files to include in the duplicate files report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of files to include in a storage report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of file groups to include in a file group report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of file screens events to include in a file screen audit report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of files in an individual duplicate group to include in a duplicate files report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of files in any file group to include in a file group report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of files for any owner to include in a files by owner report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of files for each property value to include in a files by property report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of owners to include in a files by owner report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of property values to include in a files by property report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of quotas to include in a quota usage report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a path to a folder where the server stores incident reports.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a path to a folder where the server stores on demand reports.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a path to a folder where the server stores scheduled reports.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a string of files to include in the most frequently accessed report. You can use the wildcard characters * and ? in the string.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of days since the report was last accessed, to include in the most frequently accessed report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum number of seconds between individual running events of a report notification. If multiple report notifications occur, the server runs the report notification only if at least this amount of time have passed since the server last performed this action.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a string of files to include in the file by property report. You can use the wildcard characters * and ? in the string.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the property name to report on for a file by property report.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the minimum quota usage level to include in the quota usage report.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the fully qualified domain name (FQDN) or IP address of the SMTP server that FSRM uses to send email.
You can use the Send-FsrmTestEmail cmdlet to send an email messages to test the SMTP server that you specify.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the maximum number of concurrent operations that can be established to run the cmdlet.
If this parameter is omitted or a value of
0
is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer.
The throttle limit applies only to the current cmdlet, not to the session or to the computer.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |