en-US/about_SPLogLevel.help.txt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
.NAME
    SPLogLevel

# Description
    
    **Type:** Distributed
    **Requires CredSSP:** No
    
    This resource is used to change the minimum severity of events captured in
    the trace logs (ULS logs) and the Windows event logs. Settings can be changed
    globally for all areas and categories (using the '*' character as the
    wildcard), for all categories within an area, and for specific categories
    within an area. Settings can be changed to desired valid values, or set to the
    default by using the keyword 'Default' as the trace level and event level.
    You must specify a unique name for each instance of this resource in a configuration.
    
.PARAMETER Name
    Key - String
    Friendly Name used to reference this collection of log level settings

.PARAMETER SPLogLevelSetting
    Required - String
    Collection of SPLogLevelItems to set

.PARAMETER InstallAccount
    Write - String
    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5


.EXAMPLE
    This example sets an Area / Category item to a custom value.

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

    node localhost {
        SPLogLevel SetUserProfileLogingtoVerbose
        {
            Name = "SP_Database-Verbose"
            SPLogLevelSetting = @(
                MSFT_SPLogLevelItem {
                    Area           = "SharePoint Server"
                    Name           = "Database"
                    TraceLevel     = "Verbose"
                    EventLevel     = "Verbose"
                }
            )
            PsDscRunAsCredential = $SetupAccount
        }
    }
}


.EXAMPLE
    This example sets an entire Area to the default values

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

    node localhost {
        SPLogLevel SetAllSPServerToDefault
        {
            Name = "SPServer_defaults"
            SPLogLevelSetting = @(
                MSFT_SPLogLevelItem {
                    Area           = "SharePoint Server"
                    Name           = "*"
                    TraceLevel     = "Default"
                    EventLevel     = "Default"
                }
            )
            PsDscRunAsCredential = $SetupAccount
        }
    }
}


.EXAMPLE
    This example sets multiple items to custom values

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

    node localhost {
        SPLogLevel SetCustomValues
        {
            Name = "CustomLoggingSettings"
            SPLogLevelSetting = @(
                MSFT_SPLogLevelItem {
                    Area           = "SharePoint Server"
                    Name           = "Database"
                    TraceLevel     = "Verbose"
                    EventLevel     = "Verbose"
                }
                MSFT_SPLogLevelItem {
                    Area = "Business Connectivity Services"
                    Name = "Business Data"
                    TraceLevel     = "Unexpected"
                    EventLevel     = "Error"
                }
            )
            PsDscRunAsCredential = $SetupAccount
        }
    }
}