Enable-WebRequestTracing
Enable-WebRequestTracing
Enables Request Tracing for the site specified.
Syntax
Parameter Set: Default
Enable-WebRequestTracing [[-Name] <String> ] [-CustomActions] [-Directory <String> ] [-MaxLogFiles <UInt32> ] [-MaxLogFileSize <UInt32> ] [-StatusCodes <String> ] [ <CommonParameters>]
Detailed Description
This cmdlet enables Request Tracing, and automatically configures a site rule that traces responses that have a status value between 400 and 600.
Parameters
-CustomActions
Specifies an action taken when a Request Tracing log file is generated.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Directory<String>
The directory in which Request Tracing log files are stored.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MaxLogFileSize<UInt32>
The maximum file size of a single Request Tracing log file.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MaxLogFiles<UInt32>
The maximum number of log files to store.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String>
The name of the site for which tracing is enabled.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-StatusCodes<String>
Status codes for which a default Request Tracing rule is configured. The default code value is 500.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
-------------- EXAMPLE 1: Enabling Request Tracing for the "Default Web Site" --------------
Enables Request Tracing for the Default Web Site, which also automatically creates a rule that traces status code 500 errors.
IIS:\>Enable-WebRequestTracing -Name "Default Web Site"