Udostępnij przez


Get-ProfilingResults

Polecenie cmdlet Get-ProfilingResults analizuje co najmniej jeden określony plik ETL (śledzenie zdarzeń dla systemu Windows) w celu znalezienia zdarzeń odmowy dostępu dla pakietów aplikacji i identyfikuje możliwości, które umożliwiają pakietowi wykonywanie tych dostępu. Zwraca również istotne informacje o zdarzeniach odmowy dostępu znalezionych dla pakietów.

Ważny

Ta funkcja jest dostępna w wersji zapoznawczej: Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed jej wydaniem komercyjnym. Firma Microsoft nie udziela żadnych gwarancji, wyraźnych ani domniemanych, w odniesieniu do podanych tutaj informacji.

Nazwa modułu: Microsoft.Windows.Win32Isolation.ApplicationCapabilityProfiler

Składnia

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

Parametry

-EtlFilePaths

Określa tablicę ścieżek do plików ETL, z których mają być pobierane wyniki profilowania. Get-ProfilingResults wymaga wejściowego pliku ETL. Jeśli -EtlFilePaths nie zostanie podana, polecenie cmdlet podejmie próbę zatrzymania aktywnej sesji rejestrowania śledzenia i przechwycenia z niego pliku ETL.

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

Określa tablicę nazw wykonywalnych, aby filtrować wyniki profilowania. Zostaną zwrócone tylko wyniki związane z określonymi plikami wykonywalnym.

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

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

-ManifestPath

Określa ścieżkę do pliku manifestu pakietu aplikacji, który ma być edytowany przez polecenie cmdlet z zidentyfikowanymi możliwościami. Jeśli zidentyfikowane możliwości nie mogą być przypisane do pakietu tego manifestu, kopia manifestu jest generowana dla każdego zidentyfikowanego pakietu, w tym możliwości odnoszących się do niego.

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

Określa tablicę nazw pakietów, aby filtrować wyniki profilowania. Zostaną zwrócone tylko wyniki związane z określonymi pakietami.

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

Określa ścieżkę do pliku CSV, aby zapisać szczegółowe informacje o próbie dostępu. Jeśli nie zostanie określona, zostanie użyta domyślna ścieżka wyjściowa.

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

Wskazuje, czy dane wyjściowe zawierają podsumowanie informacji dotyczących prób dostępu do niezidentyfikowanych obiektów.

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

Określa ścieżkę do pliku TXT, aby zapisać podsumowanie wyników profilowania. Jeśli nie zostanie określona, zostanie użyta domyślna ścieżka wyjściowa.

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

-Spokojny

Wskazuje, że polecenie cmdlet działa w trybie cichym, pomijając niepotrzebne dane wyjściowe i monity.

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

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest wykonywane.

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

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

-Potwierdzić

Monituje użytkownika o potwierdzenie przed uruchomieniem polecenia 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

Przykłady

Analizowanie przechwyconych informacji o dostępie do danych śledzenia i danych wyjściowych

W tym przykładzie śledzenia przechwycono start-profilowanie/Zatrzymaj profilowanie i wyprowadza informacje o dostępie do możliwości. Wszystkie informacje o dostępie do możliwości, które można dopasować do podanego manifestu pakietu aplikacji, są automatycznie dodawane do manifestu.

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

Znajdowanie i analizowanie aktywnej sesji rejestrowania śledzenia

W tym przykładzie znajduje się aktywna sesja rejestrowania śledzenia z start-profilowanie, zbiera ślad i analizuje je. Jeśli sesja rejestrowania śledzenia jest obecnie aktywna, zostanie wywołana Zatrzymaj profilowanie, aby spróbować zebrać ślad, który można przeanalizować.

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

Analizowanie wielu śladów

Poniższy przykład analizuje wiele plików ETL i generuje informacje o dostępie do możliwości.

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

profiler możliwości aplikacji

rozpoczynania profilowania

zatrzymanie profilowania

Merge-ProfilingResults