設定追蹤功能
此主題說明如何使用 AppFabric Cmdlet 針對應用程式或服務設定追蹤功能。可用於設定追蹤功能的 Cmdlet 有 Import-ASAppServiceTrackingProfile、Get-ASAppServiceTracking、Remove-ASAppServiceTrackingProfile 與 Get-ASAppServiceTrackingProfile。
若要以互動方式執行 AppFabric Cmdlet，請開啟 AppFabric 的 Windows PowerShell 主控台，輸入適當的 Cmdlet，然後按下 ENTER。如需有關執行 Cmdlet 的詳細資訊，請參閱執行 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] <字串> [[-VirtualPath] <字串>], [-Uri] <Uri>, -ApplicationObject <應用程式資訊>, -ServiceObject <服務資訊> 或 -Root |
Cmdlet 的操作範圍 |
[-FilePath] <字串> |
指定要從中匯入追蹤設定檔的檔案名稱 (包含路徑)。此為必要參數。檔案只能包含一個設定檔。 |
[-Overwrite] |
可省略。若指定此參數，會覆寫任何現有的追蹤設定檔組態。這個行為相當於在呼叫 Remove-TrackingProfile 之後呼叫 Import-TrackingParticipant 而未使用 –overwrite 旗標。若追蹤設定檔無法移除，此 Cmdlet 會失敗。 |
[-ProfileName <字串>] |
指定指派到匯入之追蹤設定檔的名稱。它指定 profile 元素的 name 屬性。此為選用參數。若指定此參數，它會覆寫在檔案中指定的名稱。 |
取得應用程式的追蹤資訊
在 Windows PowerShell 主控台中，使用描述目前服務之追蹤設定的 ServiceTrackingInfo 物件，執行 Get-ASAppServiceTracking Cmdlet 以取得服務目前的追蹤設定。該物件包含已針對服務啟用的追蹤元件清單，以及指出是否已在服務上啟用追蹤功能的旗標。此操作的目標 (範圍) 是與服務 (或服務執行個體) 關聯的 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] <字串> [[-VirtualPath] <字串>], [-Uri] <Uri>, -ApplicationObject <應用程式資訊>, -ServiceObject <服務資訊> 或 -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] <字串> [[-VirtualPath], [-Uri] <Uri>, -ApplicationObject <應用程式資訊> 或 -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] <字串> [[-VirtualPath] <字串>], [-Uri] <Uri>, -ApplicationObject <應用程式資訊>, -ServiceObject <服務資訊> 或 -Root |
Cmdlet 的操作範圍 |
-ProfileName <字串> |
指定要移除之追蹤設定檔的名稱。設定檔必須在本機目標組態檔中定義。此為必要參數。 |
取得應用程式的追蹤設定檔
在 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] <字串> [[-VirtualPath] <字串>], [-Uri] <Uri>, -ApplicationObject <應用程式資訊>, -ServiceObject <服務資訊> 或 -Root |
Cmdlet 的操作範圍 |
-ProfileName <字串> |
指定要傳回之追蹤設定檔的名稱。該設定檔可以在本機目標組態檔定義，或從其組態檔階層繼承。此為選用參數。若未指定 ProfileName 參數，會傳回與目標組態檔關聯的所有追蹤設定檔 (本機與繼承)。 |
2012-03-05