配置跟踪
本主题介绍如何使用 AppFabric cmdlet 配置应用程序或服务的跟踪。可用于配置跟踪的 cmdlet 包括 Import-ASAppServiceTrackingProfile、Get-ASAppServiceTracking、Remove-ASAppServiceTrackingProfile 和 Get-ASAppServiceTrackingProfile。
要以交互方式执行 AppFabric cmdlet,请打开 AppFabric 的 Windows PowerShell 控制台,输入相应的 cmdlet,然后按 Enter。有关执行 cmdlet 的详细信息,请参阅运行 Windows Server AppFabric Cmdlet。
导入应用程序的跟踪信息
在 Windows PowerShell 控制台中,执行 Import-ASAppServiceTrackingProfile cmdlet 以配置跟踪,该跟踪用于监控服务操作。此 cmdlet 将指定文件中的跟踪配置文件导入指定级别目标配置文件。此操作的目标(作用域)可以是计算机 Machine.config 文件;根 Web.config 文件;或其路径由站点、应用程序、应用程序虚拟目录、服务或服务实例指定的 Web.config 文件。如果指定了某个服务,则该服务必须是 .svc、.xamlx 或 .xoml 服务。
Import-ASAppServiceTrackingProfile 的语法选项:
语法 1
Import-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath] <String> [-Overwrite] [-ProfileName <String>]
语法 2
Import-ASAppServiceTrackingProfile [-Uri] <Uri> [-FilePath] <String> [-Overwrite] [-ProfileName <String>]
语法 3
Import-ASAppServiceTrackingProfile [-FilePath] <String> -ApplicationObject <ApplicationInfo> [-Overwrite] [-ProfileName <String>]
语法 4
Import-ASAppServiceTrackingProfile [-FilePath] <String> -ServiceObject <ServiceInfo> [-Overwrite] [-ProfileName <String>]
语法 5
Import-ASAppServiceTrackingProfile [-FilePath] <String> [-Overwrite] [-ProfileName <String>] -Root
参数 | 描述 |
---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo>、-ServiceObject <ServiceInfo> 或 -Root |
cmdlet 的操作作用域 |
[-FilePath] <String> |
指定要从其中导入跟踪配置文件的文件(包括路径)的名称。此参数是必需的。文件必须只包含一个配置文件。 |
[-Overwrite] |
可选。如果指定了此参数,则现有的所有跟踪配置文件配置均被覆盖。该行为等同于调用 Remove-TrackingProfile 然后调用 Import-TrackingParticipant,而不使用 –overwrite 标志。如果无法删除跟踪配置文件,则该 cmdlet 将失败。 |
[-ProfileName <String>] |
指定分配给已导入的跟踪配置文件的名称。将指定配置文件元素的名称属性。此参数为可选参数。如果指定,此参数将覆盖文件中指定的名称。 |
获取应用程序的跟踪信息
在 Windows PowerShell 控制台中,执行 Get-ASAppServiceTracking cmdlet,以使用描述服务当前跟踪设置的 ServiceTrackingInfo 对象来获取服务的当前跟踪设置。该对象包含为服务启用的跟踪组件的列表,以及用于指示服务上是否已启用跟踪的标志。此操作的目标(作用域)为与服务(或服务实例)关联的 Web.config 文件。
Get-ASAppServiceTracking 的语法选项:
语法 1
Get-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>]
语法 2
Get-ASAppServiceTracking [-Uri] <Uri>
语法 3
Get-ASAppServiceTracking -ApplicationObject <ApplicationInfo>
语法 4
Get-ASAppServiceTracking -ServiceObject <ServiceInfo>
语法 5
Get-ASAppServiceTracking -Root
参数 | 描述 |
---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo>、-ServiceObject <ServiceInfo> 或 -Root |
cmdlet 的操作作用域 |
设置应用程序的跟踪信息
在 Windows PowerShell 控制台中,执行 Set-AsAppServiceTracking cmdlet,以设置指定作用域中 Web 应用程序的跟踪信息
Set-AsAppServiceTracking 的语法选项:
语法 1
Set-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>
语法 2
Set-ASAppServiceTracking [-Uri] <Uri> -ProfileName <String>
语法 3
Set-ASAppServiceTracking -ApplicationObject <ApplicationInfo> -ProfileName <String>
语法 4
Set-ASAppServiceTracking -ProfileName <String> -ServiceObject <ServiceInfo>
语法 5
Set-ASAppServiceTracking -ProfileName <String> -Root
参数 | 描述 |
---|---|
[-SiteName] <String> [[-VirtualPath]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo> 或 -Root |
cmdlet 的操作作用域 |
-ProfileName |
包含要设置的跟踪信息的配置文件的名称 |
删除应用程序的跟踪信息
在 Windows PowerShell 控制台中,执行 Remove-ASAppServiceTrackingProfile cmdlet,以从指定级别的配置中删除跟踪配置文件。此 cmdlet 用于配置跟踪,该跟踪用于监控服务操作。
Remove-ASAppServiceTrackingProfile 的语法选项:
语法 1
Remove-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>
语法 2
Remove-ASAppServiceTrackingProfile [-Uri] <Uri> -ProfileName <String>
语法 3
Remove-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> -ProfileName <String>
语法 4
Remove-ASAppServiceTrackingProfile -ProfileName <String> -ServiceObject <ServiceInfo>
语法 5
Remove-ASAppServiceTrackingProfile -ProfileName <String> -Root
参数 | 描述 |
---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo>、-ServiceObject <ServiceInfo> 或 -Root |
cmdlet 的操作作用域 |
-ProfileName <String> |
指定要删除的跟踪配置文件的名称。必须在目标配置文件中本地定义该配置文件。此参数是必需的。 |
获取应用程序的跟踪配置文件
在 Windows PowerShell 控制台中,执行 Get-ASAppServiceTrackingProfile cmdlet,以返回 TrackingProfileInfo 类中对服务可见的跟踪配置文件(包括所有作用域中定义的配置文件)。目标配置文件的配置层次结构中的所有设置均位于此操作的作用域。这意味着它可以返回本地设置(目标文件中定义的设置)和继承的设置(Machine.config 文件或根 Web.config 文件中定义的设置)。
Get-ASAppServiceTrackingProfile 的语法选项:
语法 1
Get-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-ProfileName <String>]
语法 2
Get-ASAppServiceTrackingProfile [-Uri] <Uri> [-ProfileName <String>]
语法 3
Get-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> [-ProfileName <String>]
语法 4
Get-ASAppServiceTrackingProfile -ServiceObject <ServiceInfo> [-ProfileName <String>]
语法 5
Get-ASAppServiceTrackingProfile [-ProfileName <String>] -Root
参数 | 描述 |
---|---|
[-SiteName] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo>、-ServiceObject <ServiceInfo> 或 -Root |
cmdlet 的操作作用域 |
-ProfileName <String> |
指定要返回的跟踪配置文件的名称。配置文件可以是在目标配置文件中本地定义的,也可以是从其配置文件层级结构中继承的。此参数为可选参数。如果未指定 ProfileName 参数,将返回与目标配置文件关联的所有跟踪配置文件(本地和继承)。 |
2011-12-05