Get-ProfilingResults
O cmdlet Get-ProfilingResults analisa um ou mais arquivos ETL (Rastreamento de Eventos para Windows) especificados para encontrar eventos de acesso negado para pacotes de aplicativos e identifica recursos que permitiriam que o pacote executasse esses acessos. Ele também gera informações relevantes sobre os eventos de acesso negado encontrados para os pacotes.
Importante
Esse recurso está em versão preliminar: algumas informações estão relacionadas ao produto em pré-lançamento, o qual poderá ser modificado substancialmente antes do lançamento comercial. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.
Nome do módulo: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler
Sintaxe
Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]
Parâmetros
-EtlFilePaths
Especifica uma matriz de caminhos para os arquivos ETL dos quais os resultados da criação de perfil devem ser recuperados. Get-ProfilingResults requer um arquivo ETL de entrada. Se -EtlFilePaths não for fornecido, o cmdlet tentará interromper uma sessão de registro de rastreamento ativa e capturar um arquivo ETL dela.
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 uma matriz de nomes executáveis para filtrar os resultados da criação de perfil. Somente os resultados relacionados aos executáveis especificados serão retornados.
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 o caminho para o arquivo de manifesto do pacote de aplicativos a ser editado pelo cmdlet com os recursos identificados. Se os recursos identificados não puderem ser atribuídos ao pacote desse manifesto, uma cópia do manifesto será gerada para cada pacote identificado, incluindo os recursos pertencentes a ele.
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 uma matriz de nomes de pacote para filtrar os resultados da criação de perfil. Somente os resultados relacionados aos pacotes especificados serão retornados.
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 o caminho para um arquivo CSV para salvar informações detalhadas sobre a tentativa de acesso. Se não for especificado, o caminho de saída padrão será usado.
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 se as informações do resumo devem ser geradas para tentativas de acesso a objetos não 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 o caminho para um arquivo TXT para salvar um resumo dos resultados da criação de perfil. Se não for especificado, o caminho de saída padrão será usado.
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 o cmdlet é executado no modo silencioso, suprimindo saídas e prompts desnecessários.
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
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
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 ao usuário a confirmar antes de executar o 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
Exemplos
Analisar informações de acesso ao rastreamento capturado e ao recurso de saída
Este exemplo analisa um rastreamento capturado com Start-Profiling/Stop-Profiling e gera as informações de acesso ao recurso. Todas as informações de acesso ao recurso que podem ser correspondidas ao manifesto do pacote de aplicativos fornecido são adicionadas automaticamente ao manifesto.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
Encontrar e analisar a sessão de registro de rastreamento ativo
Este exemplo encontra uma sessão de registro de rastreamento ativa de Start-Profiling, coleta o rastreamento e o analisa. Se uma sessão de registro de rastreamento estiver ativa no momento, Stop-Profiling será chamado para tentar coletar um rastreamento que possa ser analisado.
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
Analisar vários rastreamentos
O exemplo a seguir analisa vários arquivos ETL e gera as informações de acesso ao recurso.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl