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.

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. Pobieranie wpisów zawierających 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 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 Id i Count w poleceniu, Get-History 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

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