Get-ProfilingResults
Il cmdlet Get-ProfilingResults analizza uno o più file ETL (Event Tracing for Windows) specificati per trovare gli eventi di accesso negato per i pacchetti dell'applicazione e identifica le funzionalità che consentono al pacchetto di eseguire tali accessi. Restituisce anche informazioni rilevanti sugli eventi di accesso negato trovati per i pacchetti.
Importante
Questa funzionalità è disponibile in anteprima: alcune informazioni sono correlate a un prodotto non definitiva che potrebbe essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Nome modulo: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler
Sintassi
Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]
Parametri
-EtlFilePaths
Specifica una matrice di percorsi per i file ETL da cui recuperare i risultati della profilatura. Get-ProfilingResults richiede un file ETL di input. Se -EtlFilePaths non viene specificato, il cmdlet tenterà di arrestare una sessione di registrazione della traccia attiva e di acquisire un file ETL da esso.
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
Specifica una matrice di nomi eseguibili per filtrare i risultati della profilatura. Verranno restituiti solo i risultati correlati ai file eseguibili specificati.
Type: System.String[]
Parameter Sets: (All)
Aliases: e
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManifestPath
Specifica il percorso del file manifesto del pacchetto dell'applicazione da modificare dal cmdlet con le funzionalità identificate. Se le funzionalità identificate non possono essere attribuite al pacchetto del manifesto, viene generata una copia del manifesto per ogni pacchetto identificato, incluse le funzionalità relative.
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
Specifica una matrice di nomi di pacchetti per filtrare i risultati della profilatura. Verranno restituiti solo i risultati correlati ai pacchetti specificati.
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
Specifica il percorso di un file CSV per salvare informazioni dettagliate sui tentativi di accesso. Se non specificato, verrà usato il percorso di output predefinito.
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 restituire informazioni di riepilogo per i tentativi di accesso a oggetti non identificati.
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
Specifica il percorso di un file TXT per salvare un riepilogo dei risultati della profilatura. Se non specificato, verrà usato il percorso di output predefinito.
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
-Tranquillo
Indica che il cmdlet viene eseguito in modalità non interattiva, eliminando le richieste e l'output non necessari.
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 gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
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
Richiede conferma all'utente prima di eseguire il 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
Esempi
Analizzare le informazioni di accesso alle funzionalità di traccia e output acquisite
Questo esempio analizza una traccia acquisita con Start-Profiling Stop-Profiling/ e restituisce le informazioni di accesso alle funzionalità. Tutte le informazioni di accesso alle funzionalità che possono essere abbinate al manifesto del pacchetto dell'applicazione fornite vengono aggiunte automaticamente al manifesto.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
Trovare e analizzare la sessione di registrazione della traccia attiva
In questo esempio viene trovata una sessione di registrazione di traccia attiva da Start-Profiling, viene raccolta la traccia e analizzata. Se una sessione di registrazione della traccia è attualmente attiva, verrà chiamato Stop-Profiling per tentare di raccogliere una traccia che può essere analizzata.
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
Analizzare più tracce
L'esempio seguente analizza più file ETL e restituisce le informazioni di accesso alle funzionalità.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl