Get-ProfilingResults
Командлет Get-ProfilingResults анализирует один или несколько указанных файлов ETL (Трассировка событий для Windows), чтобы найти события отказано в доступе для пакетов приложений и идентифицирует возможности, позволяющие пакету выполнять эти доступы. Он также выводит соответствующие сведения о событиях, обнаруженных доступом для пакетов.
Внимание
Эта функция доступна в предварительной версии: некоторые сведения относятся к предварительному продукту, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Имя модуля: 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
-Тихий
Указывает, что командлет выполняется в тихом режиме, подавляя ненужные выходные данные и запросы.
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
Примеры
Анализ захваченных сведений о трассировке и выходных возможностях доступа
В этом примере выполняется анализ трассировки, записанной с помощью stop-profiling Start-Profiling/, и выводится информация о доступе к возможностям. Все сведения о доступе к возможностям, которые можно сопоставить с манифестом пакета приложения, автоматически добавляются в манифест.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
Поиск и анализ активного сеанса ведения журнала трассировки
Этот пример находит активный сеанс ведения журнала трассировки из start-Profiling, собирает трассировку и анализирует его. Если сеанс ведения журнала трассировки в настоящее время активен, вызовите остановку профилирования , чтобы попытаться собрать трассировку, которую можно проанализировать.
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
Анализ нескольких трассировок
В следующем примере анализируется несколько файлов ETL и выводится информация о доступе к возможностям.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl