Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Import-ASAppServiceTrackingProfile

Import-ASAppServiceTrackingProfile

Imports a tracking profile from a text file into a Web.config configuration file. The target (scope) of this operation can be the root Web.config file or a Web.config file with a path specified by site, application, application virtual directory, service, or service instance. If a service is specified, it must be an .svc, .xamlx, or .xoml service.

Syntax

Parameter Set: SiteNameAndVirtualPath
Import-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String> ] [-FilePath] <String> [-Overwrite] [-ProfileName <String> ] [ <CommonParameters>]


Detailed Description

This cmdlet creates a <trackingProfile> configuration entry.

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?

-FilePath<String>

Path to the text file that contains the tracking profile to import.


Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Overwrite

Optional. If this parameter is specified, any existing tracking profile configuration is overwritten. The behavior is equivalent to calling Remove-TrackingProfile followed by Import-TrackingParticipant without the –overwrite flag. The cmdlet will fail if the tracking profile cannot be removed.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-ProfileName<String>

The name to assign to the profile when it is imported.


Aliases

none

Required?

false

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 search.


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?

<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 or ServiceInfo


Outputs

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

  • TrackingProfileInfo


Examples

Example 1

In this cmdlet example, the C:\myTrackingProfile.tp tracking profile is imported for the MyWorkflowApp application. This creates a configuration file entry in thetrackingProfileelement namedMyTrackingProfileName.


PS C:\Windows\system32> Import-ASAppServiceTrackingProfile -Sitename "Default Web Site" -VirtualPath "/MyWorkflowApp" -Confirm -Overwrite -ProfileName "MyTrackingProfileName" -FilePath "C:\\myTrackingProfile.tp"ConfirmAre you sure you want to perform this action?Performing operation "Import 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"): yName SiteName VirtualPath IsLocal---- -------- ----------- -------MyTrackingProfileName Default Web Site /MyWorkflowApp True
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.