Udostępnij za pośrednictwem

Start-Transcript

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

Tworzy rekord wszystkich lub części sesji programu PowerShell do pliku tekstowego.

Składnia

Start-Transcript
     [[-Path] <String>]
     [-Append]
     [-Force]
     [-NoClobber]
     [-IncludeInvocationHeader]
     [-UseMinimalHeader]
     [-WhatIf]
     [-Confirm] 
     [<CommonParameters>]
Start-Transcript
     [[-LiteralPath] <String>]
     [-Append]
     [-Force]
     [-NoClobber]
     [-IncludeInvocationHeader]
     [-UseMinimalHeader]
     [-WhatIf]
     [-Confirm] 
     [<CommonParameters>]
Start-Transcript
     [[-OutputDirectory] <String>]
     [-Append]
     [-Force]
     [-NoClobber]
     [-IncludeInvocationHeader]
     [-UseMinimalHeader]
     [-WhatIf]
     [-Confirm] 
     [<CommonParameters>]

Opis

Polecenie Start-Transcript cmdlet tworzy rekord wszystkich lub części sesji programu PowerShell do pliku tekstowego. Transkrypcja zawiera wszystkie polecenia, które użytkownik wpisze i wszystkie dane wyjściowe wyświetlane w konsoli programu .

Domyślnie Start-Transcript transkrypcja jest przechowywana w następującej lokalizacji przy użyciu nazwy domyślnej:

  • W systemie Windows: $HOME\Documents
  • W systemie Linux lub macOS: $HOME

Domyślna nazwa pliku to PowerShell_transcript.<computername>.<random>.<timestamp>.txt.

Począwszy od Windows PowerShell 5.0, Start-Transcript zawiera nazwę hosta w wygenerowanej nazwie pliku wszystkich transkrypcji. Nazwa pliku zawiera również losowe znaki w nazwach, aby zapobiec potencjalnemu zastępowaniu lub duplikowaniu podczas uruchamiania co najmniej dwóch transkrypcji jednocześnie. Dołączenie nazwy komputera jest przydatne w przypadku przechowywania transkrypcji w centralnej lokalizacji. Ciąg znaków losowych uniemożliwia odgadnięcie nazwy pliku w celu uzyskania nieautoryzowanego dostępu do pliku.

Jeśli plik docelowy nie ma znacznika kolejności bajtów (BOM), Start-Transcript domyślnie koduje Utf8NoBom kodowanie w pliku docelowym.

Przykłady

Przykład 1. Uruchamianie pliku transkrypcji z ustawieniami domyślnymi

Start-Transcript

To polecenie uruchamia transkrypcję w domyślnej lokalizacji pliku.

Przykład 2. Uruchamianie pliku transkrypcji w określonej lokalizacji

Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber

To polecenie uruchamia transkrypcję w pliku w pliku w C:\transcriptspliku Transcript0.txt . Parametr NoClobber uniemożliwia zastępowanie istniejących plików. Transcript0.txt Jeśli plik już istnieje, polecenie zakończy się niepowodzeniem.

Przykład 3. Uruchamianie pliku transkrypcji o unikatowej nazwie i przechowywanie go w udziale plików

W poniższym przykładzie tworzony jest plik transkrypcji o nazwie na tyle unikatowy, aby był przechowywany w lokalizacji udostępnionej. Nazwa pliku jest tworzona na podstawie nazwy użytkownika, nazwy hosta komputera z programem PowerShell, wersji programu PowerShell oraz daty i godziny. Transkrypcja jest przechowywana w \\Server01\Transcripts udziale plików.

$sharepath  = '\\Server01\Transcripts'
$username   = $env:USERNAME
$hostname   = hostname
$version    = $PSVersionTable.PSVersion.ToString()
$datetime   = Get-Date -f 'yyyyMMddHHmmss'
$filename   = "Transcript-${username}-${hostname}-${version}-${datetime}.txt"
$Transcript = Join-Path -Path $sharepath -ChildPath $filename
Start-Transcript

Pełna ścieżka do pliku transkrypcji jest przechowywana w zmiennej $Transcript preferencji. Aby uzyskać więcej informacji na temat zmiennej $Transcript preferencji, zobacz about_Preference_Variables.

Parametry

-Append

Wskazuje, że to polecenie cmdlet dodaje nową transkrypcję na końcu istniejącego pliku. Użyj parametru Ścieżka , aby określić plik.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Umożliwia polecenie cmdlet dołączanie transkrypcji do istniejącego pliku tylko do odczytu. W przypadku użycia w pliku tylko do odczytu polecenie cmdlet zmienia uprawnienia do odczytu i zapisu pliku. Polecenie cmdlet nie może zastąpić ograniczeń zabezpieczeń, gdy ten parametr jest używany.

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

-IncludeInvocationHeader

Wskazuje, że to polecenie cmdlet rejestruje sygnaturę czasową podczas uruchamiania poleceń.

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

-LiteralPath

Określa lokalizację pliku transkrypcji. W przeciwieństwie do parametru Path wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w znaki pojedynczego cudzysłowu. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Type:String
Aliases:PSPath, LP
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

Wskazuje, że to polecenie cmdlet nie zastępuje istniejącego pliku. Domyślnie, jeśli plik transkrypcji istnieje w określonej ścieżce, Start-Transcript zastępuje plik bez ostrzeżenia.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputDirectory

Określa określoną ścieżkę i folder, w którym ma być zapisywana transkrypcja. Program PowerShell automatycznie przypisuje nazwę transkrypcji.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Określa lokalizację pliku transkrypcji. Wprowadź ścieżkę .txt do pliku. Symbole wieloznaczne nie są dozwolone. Jeśli którykolwiek z katalogów w ścieżce nie istnieje, polecenie zakończy się niepowodzeniem.

Jeśli nie określisz ścieżki, Start-Transcript użyje ścieżki w wartości zmiennej globalnej $Transcript . Jeśli ta zmienna nie została utworzona, Start-Transcript zapisuje transkrypcje w domyślnej lokalizacji i nazwie pliku.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseMinimalHeader

Prepend krótki nagłówek do transkrypcji, zamiast szczegółowego nagłówka dołączonego domyślnie. Ten parametr został dodany w programie PowerShell 6.2.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

String

To polecenie cmdlet zwraca ciąg zawierający komunikat potwierdzający i ścieżkę do pliku wyjściowego.

Uwagi

Aby zatrzymać transkrypcję, użyj Stop-Transcript polecenia cmdlet .

Aby zarejestrować całą sesję, dodaj Start-Transcript polecenie do profilu. Aby uzyskać więcej informacji, zobacz about_Profiles.