Checkpoint-WebApplicationMonitoring
Applies To: System Center 2012 R2 Operations Manager
Checkpoint-WebApplicationMonitoring
Creates a checkpoint of the IntelliTrace file for an Internet Information Services (IIS) web application.
Syntax
Parameter Set: Default
Checkpoint-WebApplicationMonitoring [-Name] <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Checkpoint-WebApplicationMonitoring cmdlet creates a Visual Studio IntelliTrace file without stopping application monitoring. The IntelliTrace file is created in the output path that you specify in the Start-WebApplicationMonitoring cmdlet.
Parameters
-Name<String>
Specifies the name of the web application for which to create a checkpoint. This name is listed in IIS Manager. Valid values for this parameter are:
-- A web application name. A web application name must be specified as <website name>/<web application name>. For example, "Default Web Site/WebApp1".
-- An IIS path. For example, "IIS:\sites\Default Web Site\WebApp1".
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before executing the command.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
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: Create a checkpoint
This command creates a Visual Studio IntelliTrace snapshot without stopping the monitoring agent. The checkpoint contains data collected for the web application named WebApp1 in the website named Default Web. The IntelliTrace file is written to the output path specified in Start-WebApplicationMonitoring.
C:\PS>Checkpoint-WebApplicationMonitoring -Name "Default Web Site/WebApp1"