Get-ProfilingResults

De Get-ProfileResults cmdlet parseert een of meer opgegeven ETL-bestanden (Event Tracing for Windows) om toegang geweigerde gebeurtenissen te vinden voor toepassingspakketten en identificeert mogelijkheden waarmee het pakket deze toegang kan uitvoeren. Het levert ook relevante informatie op over de toegang geweigerde gebeurtenissen die voor de pakketten zijn gevonden.

Modulenaam: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler

Syntaxis

Get-ProfilingResults [[-EtlFilePaths] <string[]>] [-ExeNames <string[]>] [-ManifestPath <string>]
[-RecordsOutputPath <string>] [-SummaryOutputPath <string>] [-PackageNames <string[]>] [-Quiet]
[-ShowNoNameObjectFailures] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters

-EtlFilePaths

Hiermee geeft u een matrix van paden naar de ETL-bestanden waaruit profileringsresultaten moeten worden opgehaald. Get-ProfileResults vereist een ETL-invoerbestand. Als -EtlFilePaths niet is opgegeven, probeert de cmdlet een actieve traceerlogboeksessie te stoppen en een ETL-bestand ervan vast te leggen.

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

Hiermee geeft u een matrix met uitvoerbare namen op om de profileringsresultaten te filteren. Alleen resultaten met betrekking tot de opgegeven uitvoerbare bestanden worden geretourneerd.

Type: System.String[]
Parameter Sets: (All)
Aliases: e

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ManifestPath

Hiermee geeft u het pad naar het manifestbestand van het toepassingspakket dat moet worden bewerkt door de cmdlet met de geïdentificeerde mogelijkheden. Als de geïdentificeerde mogelijkheden niet kunnen worden toegeschreven aan het pakket van dit manifest, wordt er een kopie van het manifest gegenereerd voor elk pakket dat wordt geïdentificeerd, inclusief de mogelijkheden die hieraan betrekking hebben.

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

Hiermee geeft u een matrix van pakketnamen om de profileringsresultaten te filteren. Alleen resultaten met betrekking tot de opgegeven pakketten worden geretourneerd.

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

Hiermee geeft u het pad naar een CSV-bestand om gedetailleerde toegangspogingsgegevens op te slaan. Als dit niet is opgegeven, wordt het standaarduitvoerpad gebruikt.

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

Hiermee wordt aangegeven of er samenvattingsinformatie moet worden uitgevoerd voor toegangspogingen tot niet-geïdentificeerde objecten.

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

Hiermee geeft u het pad naar een TXT-bestand op om een samenvatting van de profileringsresultaten op te slaan. Als dit niet is opgegeven, wordt het standaarduitvoerpad gebruikt.

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

-Rustig

Geeft aan dat de cmdlet wordt uitgevoerd in de stille modus, waardoor onnodige uitvoer en prompts worden onderdrukt.

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

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Bevestigen

Vraagt de gebruiker om bevestiging voordat de cmdlet wordt uitgevoerd.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Voorbeelden

Toegangsgegevens voor vastgelegde tracerings- en uitvoermogelijkheden parseren

In dit voorbeeld wordt een tracering geparseerd die is vastgelegd met startprofilering/stopprofilering en wordt de toegangsgegevens van de mogelijkheid uitgevoerd. Alle informatie over toegang tot mogelijkheden die kunnen worden gekoppeld aan het opgegeven manifest van het toepassingspakket, wordt automatisch toegevoegd aan het manifest.

Get-ProfilingResults -EtlFilePaths C:\Logs\trace.etl -ManifestPath C:\Path\To\MyAppXManifest.xml

Actieve traceerlogboeksessie zoeken en parseren

In dit voorbeeld wordt een actieve traceringslogboeksessie gevonden van startprofilering, wordt de tracering verzameld en geparseerd. Als er momenteel een traceerlogboeksessie actief is, wordt stopprofilering aangeroepen om een tracering te verzamelen die kan worden geparseerd.

Get-ProfilingResults -ManifestPath C:\Path\To\MyAppXManifest.xml

Meerdere traceringen parseren

In het volgende voorbeeld worden meerdere ETL-bestanden geparseerd en worden de toegangsgegevens van de mogelijkheid uitgevoerd.

Get-ProfilingResults -EtlFilePaths C:\Logs\trace1.etl, C:\Logs\trace2.etl

Verwante onderwerpen

application capability profiler

startprofilering

stopprofilering

Merge-ProfileResults-