SPDiagnosticsProvider

SPDiagnosticsProvider

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
Name	Key	string	Name of the Diagnostics Provider to configure
Retention	Write	Uint16	Sets the retention period in days
MaxTotalSizeInBytes	Write	Uint64	Sets the maximum retention size in bytes
Enabled	Write	Boolean	True enables the Diagnostics Provider
Ensure	Write	string	Present to configure the diagnostics provider	Present, Absent
InstallAccount	Write	PSCredential	POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5

Description

Type: Distributed

This resource is responsible for configuring the Diagnostics Provider within the local SharePoint farm. Using Ensure equals to Absent is not supported. This resource can only apply configuration, not ensure they don't exist.

Examples

Example 1

This example shows how to configure the retention period for a Diagnostics Provider.

    Configuration Example
    {
        param(
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )
        Import-DscResource -ModuleName SharePointDsc

        node localhost {
            SPDiagnosticsProvider BlockingQueryProvider
            {
                Ensure               = "Present"
                Name                 = "job-diagnostics-blocking-query-provider"
                MaxTotalSizeInBytes  = 10000000000000
                Retention            = 14
                Enabled              = $true
                PSDscRunAsCredential = $SetupAccount
            }
        }
    }