Remove-ASAppServiceTrackingProfile

Remove-ASAppServiceTrackingProfile

Removes a tracking profile from the Web.config file at the specified level of the configuration. This action results in stopping tracking, which is used to monitor service operations.

Syntax

Parameter Set: SiteNameAndVirtualPath
Remove-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String> ] -ProfileName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

This cmdlet removes the <trackingProfile> configuration entry from the configuration file, such as the one shown below.

Parameters

-ApplicationObject<ApplicationInfo>

An object that application configuration cmdlets output.  This allows piping IIS configuration scope between commands.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

-ProfileName<String>

The name of the tracking profile to remove.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Root

Indicates that only the root web.config file should be targeted.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-ServiceObject<ServiceInfo>

An object that service configuration cmdlets output. This allows piping IIS configuration scope between commands.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

-SiteName<String>

The IIS Web Site Name used to filter the configuration.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Uri<Uri>

The Uri to an application whose configuration should be targeted.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-VirtualPath<String>

The IIS Virtual Path used to filter the configuration search.

Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Confirm

Prompts you for confirmation before executing the command.

Required?

false

Position?

named

Default Value

none

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

none

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.

  • ApplicationInfo

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

Examples

Example 1

This cmdlet example removes the tracking profile MyTrackingProfileName from the Web.config file used for MyWorkflowApp. Using –Confirm causes the user to be prompted to confirm the request.

PS C:\Windows\system32> Remove-ASAppServiceTrackingProfile -Sitename "Default Web Site" -VirtualPath "/MyWorkflowApp" -Confirm -ProfileName "MyTrackingProfileName"ConfirmAre you sure you want to perform this action?Performing operation "Remove tracking profile 'MyTrackingProfileName'" on Target "web.config at 'Default Web Site/MyWorkflowApp'".[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y