Udostępnij za pośrednictwem

Get-History

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

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

Składnia

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. 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.

Historia sesji jest zarządzana niezależnie od historii obsługiwanej przez moduł PSReadLine. Obie historie są dostępne w sesjach, w których PSReadLine. To polecenie cmdlet działa tylko z historią sesji. Aby uzyskać więcej informacji, zobacz about_PSReadLine.

Przykłady

Przykład 1. Pobieranie historii sesji

Ten przykład 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.

Get-History

Przykład 2. Pobieranie wpisów zawierających ciąg

Ten przykład 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, które obejmują usługę.

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

Przykład 3. Eksportowanie wpisów historii do określonego identyfikatora

Ten przykład 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.

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

Przykład 4. Wyświetlanie najnowszego polecenia

Ten przykład 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ę.

Get-History -Count 1

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

W tym przykładzie są wyświetlane 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.

Get-History | Format-List -Property *

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 count i Id w poleceniu, ekran kończy się poleceniem określonym przez parametr identyfikatora .

W programie Windows PowerShell 2.0 domyślnie Get-History pobiera 32 najnowsze wpisy.

Typ:Int32
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 identyfikatora i , pobiera najnowsze wpisy kończące się wpisem określonym przez parametr Id.

Typ:Int64[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

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 odbieranego elementu historii.

Uwagi

Program PowerShell zawiera następujące aliasy dla Get-History:

  • Wszystkie platformy:
    • h
    • history
    • ghy

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.