Get-ProfilingResults
Get-ProfilingResults コマンドレットは、指定された 1 つ以上の ETL (Event Tracing for Windows) ファイルを解析して、アプリケーション パッケージのアクセス拒否イベントを見つけ、パッケージがそれらのアクセスを実行できるようにする機能を識別します。 また、パッケージで見つかったアクセス拒否イベントに関する関連情報も出力します。
重要
この機能はプレビュー段階です: 一部の情報はリリース前の製品に関する内容であり、製品版がリリースされるまでに大幅に変更される可能性があります。 Microsoft はここに示されている情報について、明示か黙示かを問わず、一切保証しません。
モジュール名: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler
構文
Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]
パラメーター
-EtlFilePaths
プロファイリング結果を取得する ETL ファイルへのパスの配列を指定します。 Get-ProfilingResults には入力 ETL ファイルが必要です。 -EtlFilePaths が指定されていない場合、コマンドレットはアクティブなトレース ログ セッションを停止し、そこから ETL ファイルをキャプチャしようとします。
Type: System.String[]
Parameter Sets: (All)
Aliases: Logs, l
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExeNames
プロファイリング結果をフィルタリングするための実行可能ファイル名の配列を指定します。 指定された実行可能ファイルに関連する結果のみが返されます。
Type: System.String[]
Parameter Sets: (All)
Aliases: e
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManifestPath
識別された機能を持つコマンドレットによって編集されるアプリケーション パッケージ マニフェスト ファイルへのパスを指定します。 識別された機能がこのマニフェストのパッケージに帰属できない場合は、識別された各パッケージについて、それに関連する機能を含むマニフェストのコピーが生成されます。
Type: System.String
Parameter Sets: (All)
Aliases: m
Required: False
Position: Named
Default value: <working directory>\<package name>\AppXManfiest-Capabilities.xml
Accept pipeline input: False
Accept wildcard characters: False
-PackageNames
プロファイリング結果をフィルタリングするためのパッケージ名の配列を指定します。 指定されたパッケージに関連する結果のみが返されます。
Type: System.String[]
Parameter Sets: (All)
Aliases: p, Packages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RecordsOutputPath
詳細なアクセス試行情報を保存する CSV ファイルへのパスを指定します。 指定しない場合は、既定の出力パスが使用されます。
Type: System.String
Parameter Sets: (All)
Aliases: r, RecordsOutput, RecordsPath
Required: False
Position: Named
Default value: <working directory>\AccessAttemptRecords.csv
Accept pipeline input: False
Accept wildcard characters: False
-ShowNoNameObjectFailures
識別されていないオブジェクトへのアクセス試行の概要情報を出力するかどうかを示します。
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SummaryOutputPath
プロファイリング結果の概要を保存するための TXT ファイルへのパスを指定します。 指定しない場合は、既定の出力パスが使用されます。
Type: System.String
Parameter Sets: (All)
Aliases: s, SummaryPath, SummaryOutput
Required: False
Position: Named
Default value: <working directory>\summary.txt
Accept pipeline input: False
Accept wildcard characters: False
-静かな
コマンドレットが Quiet モードで実行され、不要な出力とプロンプトが抑制されることを示します。
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
コマンドレットを実行する前にユーザーに確認を求めます。
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
例
キャプチャしたトレースを解析し、機能アクセス情報を出力する
この例では、Start-Profiling/Stop-Profiling でキャプチャされたトレースを解析し、機能アクセス情報を出力します。 提供されたアプリケーション パッケージ マニフェストに一致する機能アクセス情報はすべて、マニフェストに自動的に追加されます。
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
アクティブなトレース ログ セッションを見つけて解析する
この例では、Start-Profiling からアクティブなトレース ログ セッションを見つけ、トレースを収集して解析します。 トレース ログ セッションが現在アクティブな場合は、解析可能なトレースを収集するために Stop-Profiling が呼び出されます。
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
複数のトレースを解析する
次の例では、複数の ETL ファイルを解析し、機能アクセス情報を出力します。
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl