Get-ProfilingResults
La cmdlet Get-ProfilingResults analyse un ou plusieurs fichiers ETL (Event Tracing for Windows) spécifiés pour identifier les événements d'accès refusé pour les packages d'application et détermine les capacités qui permettraient au package d'effectuer ces accès. Elle produit également des informations pertinentes sur les événements d’accès refusé trouvés pour les packages.
Important
Cette fonctionnalité est en cours d'évaluation : Certaines informations concernent un produit en préversion qui peut être modifié de manière substantielle avant d'être commercialisé. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.
Nom du module : Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler
Syntaxe
Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]
Paramètres
-EtlFilePaths
Spécifie un tableau de chemins vers les fichiers ETL à partir desquels les résultats du profilage doivent être récupérés. Get-ProfilingResults nécessite un fichier ETL en entrée. Si -EtlFilePaths n'est pas fourni, la cmdlet tentera d'arrêter une session de journalisation de trace active et de capturer un fichier ETL à partir de celle-ci.
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
Spécifie un tableau de noms d'exécutables pour filtrer les résultats du profilage. Seuls les résultats liés aux exécutables spécifiés seront retournés.
Type: System.String[]
Parameter Sets: (All)
Aliases: e
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManifestPath
Spécifie le chemin vers le fichier manifeste du package d'application à éditer par la cmdlet avec les capacités identifiées. Si les capacités identifiées ne peuvent pas être attribuées au package de ce manifeste, une copie du manifeste est générée pour chaque package identifié, y compris les capacités qui y sont associées.
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
Spécifie un tableau de noms de packages pour filtrer les résultats du profilage. Seuls les résultats liés aux packages spécifiés seront retournés.
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
Spécifie le chemin vers un fichier CSV pour enregistrer les informations détaillées sur les tentatives d'accès. Si non spécifié, le chemin de sortie par défaut sera utilisé.
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
Indique s'il faut produire des informations récapitulatives pour les tentatives d'accès à des objets non identifiés.
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
Spécifie le chemin vers un fichier TXT pour enregistrer un résumé des résultats du profilage. Si non spécifié, le chemin de sortie par défaut sera utilisé.
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
Indique que la cmdlet s'exécute en mode silencieux, supprimant les sorties et les invites inutiles.
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
Montre ce qui se passe en cas d’exécution de la commande cmdlet. La cmdlet n’est pas exécutée.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Confirmer
Invite l'utilisateur à confirmer avant d'exécuter la 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
Exemples
Analyser la trace capturée et produire les informations d'accès aux capacités
Cet exemple analyse une trace capturée avec Start-Profiling/Stop-Profiling et produit les informations d'accès aux capacités. Toute information d'accès aux capacités pouvant être associée au manifeste du package d'application fourni est automatiquement ajoutée au manifeste.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml
Rechercher et analyser une session de journalisation de trace active
Cet exemple trouve une session de journalisation de trace active à partir de Start-Profiling, collecte la trace et l'analyse. Si une session de journalisation de trace est actuellement active, Stop-Profiling sera appelé pour tenter de collecter une trace qui peut être analysée.
Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml
Analyser plusieurs traces
L'exemple suivant analyse plusieurs fichiers ETL et produit les informations d'accès aux capacités.
Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl