追跡の構成
このトピックでは、AppFabric コマンドレットを使用して、アプリケーションまたはサービスの追跡を構成する方法について説明します。追跡の構成に使用できるコマンドレットは、Import-ASAppServiceTrackingProfile、Get-ASAppServiceTracking、Remove-ASAppServiceTrackingProfile、および Get-ASAppServiceTrackingProfile です。
AppFabric コマンドレットを対話的に実行するには、AppFabric 用の Windows PowerShell コンソールを開き、適切なコマンドレットを入力し、Enter キーを押します。コマンドレットの実行の詳細については、「AppFabric コマンドレットの実行」を参照してください。
アプリケーションの追跡情報をインポートするには
Windows PowerShell コンソールで Import-ASAppServiceTrackingProfile コマンドレットを実行し、サービス操作を監視するために使用する追跡を構成します。このコマンドレットは、指定したファイルから、指定したレベルのターゲット構成ファイルに追跡プロファイルをインポートします。この操作のターゲット (スコープ) は、コンピューターの 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 |
コマンドレットの操作スコープ |
[-FilePath] <String> |
追跡プロファイルのインポート元となるファイルの名前 (パスを含む) を指定します。このパラメーターは必須です。ファイルには 1 つのプロファイルだけが含まれている必要があります。 |
[-Overwrite] |
省略可能です。このパラメーターを指定すると、既存の追跡プロファイル構成が上書きされます。このビヘイビアーは、Remove-TrackingProfile を呼び出してから、-overwrite フラグを指定せずに Import-TrackingParticipant を呼び出すのと同じです。追跡プロファイルを削除できない場合、コマンドレットは失敗します。 |
[-ProfileName <String>] |
インポートした追跡プロファイルに割り当てる名前を指定します。これにより、プロファイル要素の名前属性が指定されます。このパラメーターは省略可能です。このパラメーターを指定した場合は、ファイル内で指定されている名前よりも優先されます。 |
アプリケーションの追跡情報を取得するには
Windows PowerShell コンソールで Get-ASAppServiceTracking コマンドレットを実行し、サービスの現在の追跡設定を示す 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 |
コマンドレットの操作スコープ |
アプリケーションの追跡情報を設定するには
Windows PowerShell コンソールで Set-AsAppServiceTracking コマンドレットを実行し、指定したスコープで 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 |
コマンドレットの操作スコープ |
-ProfileName |
設定する追跡情報が含まれているプロファイルの名前 |
アプリケーションの追跡情報を削除するには
Windows PowerShell コンソールで Remove-ASAppServiceTrackingProfile コマンドレットを実行し、指定した構成レベルから追跡プロファイルを削除します。このコマンドレットは、サービス操作の監視に使用する追跡を構成するときに使用します。
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 |
コマンドレットの操作スコープ |
-ProfileName <String> |
削除する追跡プロファイルの名前を指定します。プロファイルは、ターゲット構成ファイルにローカルで定義されている必要があります。このパラメーターは必須です。 |
アプリケーションの追跡プロファイルを取得するには
Windows PowerShell コンソールで Get-ASAppServiceTrackingProfile コマンドレットを実行し、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 |
コマンドレットの操作スコープ |
-ProfileName <String> |
戻す追跡プロファイルの名前を指定します。ターゲット構成ファイルにローカルで定義されているプロファイル、または構成ファイル階層から継承されたプロファイルのどちらかを指定できます。このパラメーターは省略可能です。ProfileName パラメーターを指定しないと、ターゲット構成ファイルに関連付けられているすべての追跡プロファイル (ローカルと継承の両方) が戻されます。 |
2012-03-05