Export (0) Print
Expand All
Expand Minimize

Enable-WebRequestTracing

Windows Server 2012 R2 and Windows 8.1

Updated: February 20, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

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.

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"

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft