xIisLogging

xIisLogging

Important

This resource has been renamed in the latest release, see IisLogging. Bug fixes and new functionality will only be added to the renamed resource.

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
LogPath	Key	String	The directory to be used for logfiles
LogFlags	Write	StringArray[]	The W3C logging fields	Date, Time, ClientIP, UserName, SiteName, ComputerName, ServerIP, Method, UriStem, UriQuery, HttpStatus, Win32Status, BytesSent, BytesRecv, TimeTaken, ServerPort, UserAgent, Cookie, Referer, ProtocolVersion, Host, HttpSubStatus
LogPeriod	Write	String	How often the log file should rollover	Hourly, Daily, Weekly, Monthly, MaxSize
LogTruncateSize	Write	String	How large the file should be before it is truncated
LoglocalTimeRollover	Write	Boolean	Use the localtime for file naming and rollover
LogFormat	Write	String	Format of the Logfiles. Only W3C supports LogFlags	IIS, W3C, NCSA
LogTargetW3C	Write	String	Specifies whether IIS will use Event Tracing or file logging	File, ETW, File,ETW
LogCustomFields	Write	MSFT_xLogCustomField[]	Custom logging field information in the form of an array of embedded instances of MSFT_xLogCustomField CIM class

MSFT_xLogCustomField

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
LogFieldName	Required	String	Name for the custom field
SourceName	Required	String	Name for the source type
SourceType	Required	String	Specify the source type	RequestHeader, ResponseHeader, ServerVariable
Ensure	Write	String	Indicates if the custom log field should be present or absent. Defaults to Present.	Present, Absent

Description

The xIISLogging DSC resource is used to set the logfile settings for all websites; for individual websites use the Log options under xWebSite.

Requirements

• Target machine must be running Windows Server 2012 R2 or later.

Known issues

All issues are not listed here, see here for all open issues.

Examples

Example 1

configuration Sample_xIisLogging_LogFlags
{
    param
    (
        # Target nodes to apply the configuration
        [String[]] $NodeName = 'localhost'
    )

    # Import the module that defines custom resources
    Import-DscResource -Module xWebAdministration

    Node $NodeName
    {
        xIisLogging Logging
        {
            LogPath              = 'C:\IISLogFiles'
            Logflags             = @('Date', 'Time', 'ClientIP', 'ServerIP', 'UserAgent')
            LogFormat            = 'W3C'
        }
    }
}

Example 2

configuration Sample_xIisLogging_Rollover
{
    param
    (
        # Target nodes to apply the configuration
        [String[]] $NodeName = 'localhost'
    )

    # Import the module that defines custom resources
    Import-DscResource -Module xWebAdministration

    Node $NodeName
    {
        xIisLogging Logging
        {
            LogPath              = 'C:\IISLogFiles'
            Logflags             = @('Date', 'Time', 'ClientIP', 'UserName', 'ServerIP')
            LoglocalTimeRollover = $true
            LogPeriod            = 'Hourly'
            LogFormat            = 'W3C'
        }
    }
}

Example 3

configuration Sample_xIisLogging_Truncate
{
    param
    (
        # Target nodes to apply the configuration
        [String[]] $NodeName = 'localhost'
    )

    # Import the module that defines custom resources
    Import-DscResource -Module xWebAdministration

    Node $NodeName
    {
        xIisLogging Logging
        {
            LogPath              = 'C:\IISLogFiles'
            Logflags             = @('Date', 'Time', 'ClientIP', 'UserName', 'ServerIP')
            LoglocalTimeRollover = $true
            LogTruncateSize      = '2097152'
            LogFormat            = 'W3C'
        }
    }
}