Get-ProfilingResults
Das Cmdlet Get-ProfilingResults analysiert eine oder mehrere angegebene ETL-Dateien (Ereignisablaufverfolgung für Windows), um Zugriffsverweigerungsereignisse für Anwendungspakete zu finden und Funktionen zu identifizieren, mit denen das Paket diese Zugriffe ausführen kann. Außerdem werden relevante Informationen zu den für die Pakete gefundenen Zugriffsverweigerungsereignissen ausgegeben.
Wichtig
Dieses Feature befindet sich in der Vorschauphase: Einige Informationen beziehen sich auf ein Vorabversionsprodukt, an dem vor der kommerziellen Freigabe möglicherweise wesentliche Änderungen vorgenommen werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Modulname: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler
Syntax
Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]
Parameter
-EtlFilePaths
Gibt ein Array von Pfaden zu den ETL-Dateien an, aus denen Profilerstellungsergebnisse abgerufen werden sollen. Get-ProfilingResults erfordert eine ETL-Eingabedatei. Wenn -EtlFilePaths nicht angegeben ist, versucht das Cmdlet, eine aktive Sitzung für die Ablaufverfolgungsprotokollierung zu beenden und eine ETL-Datei davon zu erfassen.
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
Gibt ein Array von ausführbaren Namen an, um die Profilerstellungsergebnisse zu filtern. Es werden nur Ergebnisse zurückgegeben, die sich auf die angegebenen ausführbaren Dateien beziehen.
Type: System.String[]
Parameter Sets: (All)
Aliases: e
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManifestPath
Gibt den Pfad zur Anwendungspaketmanifestdatei an, die vom Cmdlet mit den identifizierten Funktionen bearbeitet werden soll. Wenn die identifizierten Funktionen nicht dem Paket dieses Manifests zugeordnet werden können, wird eine Kopie des Manifests für jedes Paket generiert, das identifiziert wird, einschließlich der darin enthaltenen Funktionen.
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
Gibt ein Array von Paketnamen an, um die Profilerstellungsergebnisse zu filtern. Es werden nur Ergebnisse zurückgegeben, die sich auf die angegebenen Pakete beziehen.
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
Gibt den Pfad zu einer CSV-Datei an, um detaillierte Informationen zu Zugriffsversuchen zu speichern. Wird kein Pfad angegeben, wird der Standardausgabepfad verwendet.
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
Gibt an, ob Zusammenfassungsinformationen für Zugriffsversuche auf nicht identifizierte Objekte ausgegeben werden sollen.
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
Gibt den Pfad zu einer TXT-Datei an, um eine Zusammenfassung der Profilerstellungsergebnisse zu speichern. Wird kein Pfad angegeben, wird der Standardausgabepfad verwendet.
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
Gibt an, dass das Cmdlet im Hintergrundmodus ausgeführt wird und unnötige Ausgaben und Eingabeaufforderungen unterdrückt.
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
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
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
Hiermit wird der Benutzer vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Beispiele
Analysieren erfasster Informationen zum zu Ablaufverfolgungs- und Ausgabefunktionszugriff
In diesem Beispiel wird eine Ablaufverfolgung analysiert, die mit Start-Profiling/Stop-Profiling erfasst wird, und es werden Informationen zum Funktionszugriff ausgegeben. Alle Funktionszugriffsinformationen, die auf das bereitgestellte Anwendungspaketmanifest abgestimmt werden können, werden dem Manifest automatisch hinzugefügt.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
Suchen und Analysieren der aktiven Ablaufverfolgungsprotokollierungssitzung
In diesem Beispiel wird eine aktive Sitzung für die Ablaufverfolgungsprotokollierung von Start-Profiling ermittelt, die Ablaufverfolgung erfasst und analysiert. Wenn derzeit eine Sitzung für die Ablaufverfolgungsprotokollierung aktiv ist, wird Stop-Profiling aufgerufen, um zu versuchen, eine Ablaufverfolgung zu erfassen, die analysiert werden kann.
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
Analysieren mehrerer Ablaufverfolgungen
Im folgenden Beispiel werden mehrere ETL-Dateien analysiert und die Informationen zum Funktionszugriff ausgegeben.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl