Get-ProfilingResults
이 Get-ProfilingResults cmdlet은 하나 이상의 지정된 ETL(Windows용 이벤트 추적) 파일을 구문 분석하여 애플리케이션 패키지에 대한 액세스 거부 이벤트를 찾고 패키지가 해당 액세스를 수행할 수 있도록 하는 기능을 식별합니다. 또한 패키지에 대해 발견된 액세스 거부 이벤트에 대한 관련 정보를 출력합니다.
Important
이 기능은 미리 보기 상태입니다. 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. 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 가 제공되지 않은 경우 cmdlet은 활성 추적 로깅 세션을 중지하고 해당 세션에서 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
식별된 기능을 사용하여 cmdlet에서 편집할 애플리케이션 패키지 매니페스트 파일의 경로를 지정합니다. 식별된 기능이 이 매니페스트의 패키지에 기인할 수 없는 경우 매니페스트의 복사본은 이에 관련된 기능을 포함하여 식별된 각 패키지에 대해 생성됩니다.
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
cmdlet이 자동 모드로 실행되어 불필요한 출력 및 프롬프트를 표시하지 않습니다.
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
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet은 실행되지 않습니다.
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
cmdlet을 실행하기 전에 사용자에게 확인 메시지가 표시됩니다.
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