en-US/about_FSRMFileScreenAction.help.txt
|
.NAME
FSRMFileScreenAction # Description This resource is used to configure File Screen Actions for File Screens in File Server Resource Manager. .PARAMETER Path Key - string The path of the FSRM File Screen the action applies to. .PARAMETER Type Key - string Allowed values: Email, Event, Command, Report The type of FSRM Action. .PARAMETER Ensure Write - String Allowed values: Present, Absent Specifies whether the FSRM Action should exist. .PARAMETER Subject Write - string The subject of the e-mail sent. Required when Type is Email. .PARAMETER Body Write - string The body text of the e-mail or event. Required when Type is Email or Event. .PARAMETER MailTo Write - string The mail to of the e-mail sent. Required when Type is Email. .PARAMETER MailCC Write - string The mail CC of the e-mail sent. Required when Type is Email. .PARAMETER MailBCC Write - string The mail BCC of the e-mail sent. Required when Type is Email. .PARAMETER EventType Write - string Allowed values: None, Information, Warning, Error The type of event created. Required when Type is Event. .PARAMETER Command Write - string The Command to execute. Required when Type is Command. .PARAMETER CommandParameters Write - string The Command Parameters. Required when Type is Command. .PARAMETER KillTimeOut Write - sint32 Int containing kill timeout of the command. Required when Type is Command. .PARAMETER RunLimitInterval Write - sint32 Int containing the run limit interval of the command. Required when Type is Command. .PARAMETER SecurityLevel Write - string Allowed values: None, LocalService, NetworkService, LocalSystem The security level the command runs under. Required when Type is Command. .PARAMETER ShouldLogError Write - boolean The working directory of the command. Required when Type is Command. .PARAMETER WorkingDirectory Write - string The type of event created. Required when Type is Event. .PARAMETER ReportTypes Write - string Array of Reports to create. Required when Type is Report. .EXAMPLE This configuration will assign an Active FSRM File Screen to the path 'D:\Users' with three include groups. An e-mail and event action is bound to the File Screen. Configuration Example { param ( [Parameter()] [System.String[]] $NodeName = 'localhost' ) Import-DscResource -Module FSRMDsc Node $NodeName { FSRMFileScreen DUsersFileScreen { Path = 'd:\users' Description = 'File Screen for Blocking Some Files' Ensure = 'Present' Active = $true IncludeGroup = 'Audio and Video Files', 'Executable Files', 'Backup Files' } # End of FSRMFileScreen Resource FSRMFileScreenAction DUsersFileScreenSomeFilesEmail { Path = 'd:\users' Ensure = 'Present' Type = 'Email' Subject = 'Unauthorized file matching [Violated File Group] file group detected' Body = 'The system detected that user [Source Io Owner] attempted to save [Source File Path] on [File Screen Path] on server [Server]. This file matches the [Violated File Group] file group which is not permitted on the system.' MailBCC = '' MailCC = 'fileserveradmins@contoso.com' MailTo = '[Source Io Owner Email]' DependsOn = "[FSRMFileScreen]DUsersFileScreen" } # End of FSRMFileScreenAction Resource FSRMFileScreenAction DUsersFileScreenSomeFilesEvent { Path = 'd:\users' Ensure = 'Present' Type = 'Event' Body = 'The system detected that user [Source Io Owner] attempted to save [Source File Path] on [File Screen Path] on server [Server]. This file matches the [Violated File Group] file group which is not permitted on the system.' EventType = 'Warning' DependsOn = "[FSRMFileScreen]DUsersFileScreen" } # End of FSRMFileScreenAction Resource } # End of Node } # End of Configuration .EXAMPLE This configuration will assign the 'Block Some Files' file screen template to the path 'D:\Users'. It will also force the File Screen assigned to this path to exactly match the 'Block Some Files' template. Any changes to the actions, include groups or active setting on the File Screen assigned to this path will cause the File Screen to be removed and reapplied. Configuration Example { param ( [Parameter()] [System.String[]] $NodeName = 'localhost' ) Import-DscResource -Module FSRMDsc Node $NodeName { FSRMFileScreen DUsersFileScreens { Path = 'd:\users' Description = 'File Screen for Blocking Some Files' Ensure = 'Present' Template = 'Block Some Files' MatchesTemplate = $true } # End of FSRMFileScreen Resource } # End of Node } # End of Configuration |