Stop-WebApplicationMonitoring
Applies To: System Center 2012 R2 Operations Manager
Stop-WebApplicationMonitoring
Stops monitoring an Internet Information Services (IIS) web application.
Syntax
Parameter Set: All
Stop-WebApplicationMonitoring [-All] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ApplicationName
Stop-WebApplicationMonitoring [-Name] <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Stop-WebApplicationMonitoring cmdlet stops monitoring an IIS web application and creates a Visual Studio IntelliTrace file with data collected while monitoring.
If the application is being monitored in trace mode, Stop-WebApplicationMonitoring stops monitoring all applications in the application pool that contains the specified application. To see the monitoring mode for an application, use the Get-WebApplicationMonitoringStatus cmdlet.
Stop-WebApplicationMonitoring must be run with sufficient permissions to recycle the application pool in which the web application is running. By default, this requires administrator permissions.
Parameters
-All
Stops monitoring all web applications.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Stops monitoring an application without prompting for confirmation. If the application is being monitored in trace mode, by default, Stop-WebApplicationMonitoring confirms that you want to stop monitoring for all applications in the application pool that contains the specified application.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the name of the web application to stop monitoring. 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 (ByValue, 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: Stop monitoring an application
This command stops monitoring for the application named WebApp1 in the website named Default Web Site. The application pool is recycled when no other applications in the application pool are monitored. The IntelliTrace file is written to the output path specified in Start-WebApplicationMonitoring.
C:\PS>Stop-WebApplicationMonitoring -Name "Default Web Site/WebApp1"
Related topics
Start-WebApplicationMonitoring