Udostępnij za pomocą

Get-History

Moduł:
Microsoft.PowerShell.Core Module

Pobiera listę poleceń wprowadzonych podczas bieżącej sesji.

Składnia

Default (domyślnie) 

Get-History
    [[-Id] <Int64[]>]
    [[-Count] <Int32>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Get-History pobiera historię sesji, czyli listę poleceń wprowadzonych podczas bieżącej sesji.

Program PowerShell automatycznie zachowuje historię każdej sesji. Liczba wpisów w historii sesji jest określana przez wartość zmiennej preferencji $MaximumHistoryCount. Począwszy od programu Windows PowerShell 3.0, wartość domyślna to 4096.

Historię sesji można zapisać w formacie XML lub CSV. Domyślnie pliki historii są zapisywane w katalogu głównym, ale plik można zapisać w dowolnej lokalizacji.

Aby uzyskać więcej informacji na temat funkcji historii w programie PowerShell, zobacz about_History w witrynie Microsoft Docs.

Przykłady

Przykład 1. Pobieranie historii sesji

Get-History

To polecenie pobiera wpisy w historii sesji. Na ekranie domyślnym jest wyświetlane każde polecenie i jego identyfikator, który wskazuje kolejność, w jakiej zostały uruchomione.

Przykład 2: Pobierz wpisy zawierające ciąg

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

To polecenie pobiera wpisy w historii poleceń, które zawierają usługę ciągów. Pierwsze polecenie pobiera wszystkie wpisy w historii sesji. Operator potoku (|) przekazuje wyniki do polecenia cmdlet Where-Object, które wybiera tylko polecenia zawierające usługę.

Przykład 3. Eksportowanie co najwyżej siedmiu wpisów

Get-History -ID 7 -Count 5 | Export-Csv History.csv

To polecenie pobiera pięć najnowszych wpisów historii kończących się wpisem 7. Operator potoku przekazuje wynik do polecenia cmdlet Export-Csv, które formatuje historię jako tekst rozdzielony przecinkami i zapisuje go w pliku History.csv. Plik zawiera dane wyświetlane podczas formatowania historii jako listy. Obejmuje to stan i czas rozpoczęcia i zakończenia polecenia.

Przykład 4. Wyświetlanie najnowszego polecenia

Get-History -Count 1

To polecenie pobiera ostatnie polecenie w historii poleceń. Ostatnie polecenie to ostatnio wprowadzone polecenie. To polecenie używa parametru Count, aby wyświetlić tylko jedno polecenie. Domyślnie get-history pobiera najnowsze polecenia. To polecenie można skrócić do "h -c 1" i jest równoważne naciśnięciu strzałki w górę.

Przykład 5. Wyświetlanie wszystkich właściwości wpisów w historii

Get-History | Format-List -Property *

To polecenie wyświetla wszystkie właściwości wpisów w historii sesji. Operator potoku przekazuje wyniki polecenia Get-History do polecenia cmdlet Format-List, które wyświetla wszystkie właściwości każdego wpisu historii. Obejmuje to identyfikator, stan oraz godziny rozpoczęcia i zakończenia polecenia.

Parametry

-Count

Określa liczbę najnowszych wpisów historii pobieranych przez to polecenie cmdlet. Domyślnie get-history pobiera wszystkie wpisy w historii sesji. Jeśli używasz parametrów liczba i Id w poleceniu, wyświetlanie kończy się na poleceniu określonym przez parametr Id.

W programie Windows PowerShell 2.0 domyślnie get-history pobiera 32 najnowsze wpisy.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Określa tablicę identyfikatorów wpisów w historii sesji. Get-History pobiera tylko określone wpisy. Jeśli używasz parametrów Id i Count w poleceniu, Get-History pobiera najnowsze wpisy kończące się wpisem określonym przez parametr Id.

Właściwości parametru

Typ:

Int64[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Int64

Możesz przekazać identyfikator historii do tego polecenia cmdlet.

Dane wyjściowe

HistoryInfo

To polecenie cmdlet zwraca obiekt historii dla każdego elementu historii, który otrzymuje.

Uwagi

  • Historia sesji to lista poleceń wprowadzonych podczas sesji. Historia sesji reprezentuje kolejność uruchamiania, stan oraz czas rozpoczęcia i zakończenia polecenia. Po wprowadzeniu każdego polecenia program PowerShell dodaje go do historii, aby można było go ponownie użyć. Aby uzyskać więcej informacji na temat historii poleceń, zobacz about_History.
  • Począwszy od programu Windows PowerShell 3.0, domyślną wartością zmiennej preferencji $MaximumHistoryCount jest 4096. W programie Windows PowerShell 2.0 wartość domyślna to 64. Aby uzyskać więcej informacji na temat zmiennej $MaximumHistoryCount, zobacz about_Preference_Variables.