Get-ProfilingResults
El cmdlet Get-ProfilingResults analiza uno o varios archivos ETL (seguimiento de eventos para Windows) especificados para buscar eventos de acceso denegado para los paquetes de aplicación e identifica las funcionalidades que permitirían al paquete realizar esos accesos. También genera información relevante sobre los eventos de acceso denegado encontrados para los paquetes.
Importante
Esta característica está en versión preliminar: parte de la información hace referencia al producto de versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.
Nombre del módulo: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler
Sintaxis
Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]
Parámetros
-EtlFilePaths
Especifica una matriz de rutas de acceso a los archivos ETL desde los que se deben recuperar los resultados de generación de perfiles. Get-ProfilingResults requiere un archivo ETL de entrada. Si -EtlFilePaths no se proporciona, el cmdlet intentará detener una sesión de registro de seguimiento activa y capturar un archivo ETL desde él.
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
Especifica una matriz de nombres ejecutables para filtrar los resultados de generación de perfiles. Solo se devolverán los resultados relacionados con los ejecutables especificados.
Type: System.String[]
Parameter Sets: (All)
Aliases: e
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManifestPath
Especifica la ruta de acceso al archivo de manifiesto del paquete de aplicación que va a editar el cmdlet con las funcionalidades identificadas. Si las funcionalidades identificadas no se pueden atribuir al paquete de este manifiesto, se genera una copia del manifiesto para cada paquete identificado, incluidas las funcionalidades que pertenecen a este.
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
Especifica una matriz de nombres de paquetes para filtrar los resultados de generación de perfiles. Solo se devolverán los resultados relacionados con los paquetes especificados.
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
Especifica la ruta de acceso a un archivo CSV para guardar información detallada del intento de acceso. Si no se especifica, se usará la ruta de salida predeterminada.
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
Indica si se va a generar información de resumen para los intentos de acceso a objetos no identificados.
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
Especifica la ruta de acceso a un archivo TXT para guardar un resumen de los resultados de generación de perfiles. Si no se especifica, se usará la ruta de salida predeterminada.
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
Indica que el cmdlet se ejecuta en modo silencioso, lo que suprime los mensajes y la salida innecesarios.
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
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
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
Solicita al usuario confirmación antes de ejecutar el 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
Ejemplos
Análisis de la información de acceso de la funcionalidad de seguimiento y salida capturadas
En este ejemplo se analiza un seguimiento capturado con Start-Profiling/Stop-Profiling y se genera la información de acceso de la funcionalidad. Cualquier información de acceso de funcionalidad que pueda coincidir con el manifiesto del paquete de aplicación proporcionado se agrega automáticamente al manifiesto.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
Búsqueda y análisis de la sesión de registro de seguimiento activo
En este ejemplo se busca una sesión de registro de seguimiento activa de Start-Profiling, se recopila el seguimiento y se analiza. Si una sesión de registro de seguimiento está activa actualmente, se llamará a Stop-Profiling para intentar recopilar un seguimiento que se pueda analizar.
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
Análisis de varios seguimientos
En el ejemplo siguiente se analizan varios archivos ETL y se genera la información de acceso de la funcionalidad.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl