DSCResources/DSC_FSRMFileScreenTemplateAction/en-US/about_FSRMFileScreenTemplateAction.help.txt

.NAME
    FSRMFileScreenTemplateAction
 
.DESCRIPTION
    This resource is used to configure File Screen Template Actions for File Screen
    Templates in File Server Resource Manager.
 
.PARAMETER Name
    Key - String
    The name of the FSRM File Screen Template that this Action is attached 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
    Boolean specifying if command errors should be logged. Required when Type is Command.
 
.PARAMETER WorkingDirectory
    Write - String
    The working directory of the command. Required when Type is Command.
 
.PARAMETER ReportTypes
    Write - StringArray
    Array of Reports to create. Required when Type is Report.
 
.EXAMPLE 1
 
This configuration will create an Active FSRM File Screen Template called 'Block Some Files',
with three include groups. An e-mail and event action is bound to the File Screen Template.
 
Configuration FSRMFileScreenTemplateAction_Config
{
    Import-DscResource -Module FSRMDsc
 
    Node localhost
    {
        FSRMFileScreenTemplate FileScreenSomeFiles
        {
            Name = 'Block Some Files'
            Description = 'File Screen for Blocking Some Files'
            Ensure = 'Present'
            Active = $true
            IncludeGroup = 'Audio and Video Files', 'Executable Files', 'Backup Files'
        } # End of FSRMFileScreenTemplate Resource
 
        FSRMFileScreenTemplateAction FileScreenSomeFilesEmail
        {
            Name = 'Block Some Files'
            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 = "[FSRMFileScreenTemplate]FileScreenSomeFiles"
        } # End of FSRMFileScreenTemplateAction Resource
 
        FSRMFileScreenTemplateAction FileScreenSomeFilesEvent
        {
            Name = 'Block Some Files'
            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 = "[FSRMFileScreenTemplate]FileScreenSomeFiles"
        } # End of FSRMFileScreenTemplateAction Resource
    } # End of Node
} # End of Configuration