Start-Transcript
Vytvoří záznam celé relace PowerShellu nebo jeho části s textovým souborem.
Syntax
ByPath (Výchozí)
Start-Transcript
[[-Path] <String>]
[-Append]
[-Force]
[-NoClobber]
[-IncludeInvocationHeader]
[-UseMinimalHeader]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByLiteralPath
Start-Transcript
[[-LiteralPath] <String>]
[-Append]
[-Force]
[-NoClobber]
[-IncludeInvocationHeader]
[-UseMinimalHeader]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByOutputDirectory
Start-Transcript
[[-OutputDirectory] <String>]
[-Append]
[-Force]
[-NoClobber]
[-IncludeInvocationHeader]
[-UseMinimalHeader]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Start-Transcript vytvoří záznam celé relace PowerShellu nebo jeho části s textovým souborem. Přepis obsahuje všechny příkazy, které uživatel zadá, a veškerý výstup, který se zobrazí v konzole.
Ve výchozím nastavení Start-Transcript uloží přepis do následujícího umístění s výchozím názvem:
- Ve Windows:
$HOME\Documents - V Linuxu nebo macOS:
$HOME
Výchozí název souboru je PowerShell_transcript.<computername>.<random>.<timestamp>.txt.
Počínaje Windows PowerShellem 5.0 Start-Transcript zahrne název hostitele do vygenerovaného názvu souboru všech přepisů. Název souboru obsahuje také náhodné znaky v názvech, aby se zabránilo potenciálnímu přepsání nebo duplikaci, když současně spustíte dva nebo více přepisů. Zahrnutí názvu počítače je užitečné, pokud přepisy ukládáte do centralizovaného umístění. Řetězec náhodného znaku zabraňuje uhodnutí názvu souboru, aby získal neoprávněný přístup k souboru.
Pokud cílový soubor nemá značku pořadí bajtů (BOM), Start-Transcript ve výchozím nastavení Utf8NoBom kódování v cílovém souboru.
Příklady
Příklad 1: Spuštění souboru přepisu s výchozím nastavením
Start-Transcript
Tento příkaz spustí přepis ve výchozím umístění souboru.
Příklad 2: Spuštění souboru přepisu v určitém umístění
Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber
Tento příkaz spustí přepis v souboru Transcript0.txt v C:\transcripts.
parametr NoClobber zabraňuje přepsání existujících souborů. Pokud soubor Transcript0.txt již existuje, příkaz selže.
Příklad 3: Spuštění souboru přepisu s jedinečným názvem a jeho uložením do sdílené složky
Následující příklad vytvoří soubor přepisu s jedinečným názvem, který je dostatečně jedinečný, aby byl uložen ve sdíleném umístění. Název souboru se sestaví z uživatelského jména, názvu hostitele počítače s PowerShellem, verze PowerShellu a data a času. Přepis se uloží do sdílené složky \\Server01\Transcripts.
$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
Úplná cesta k souboru přepisu je uložená v proměnné předvoleb $Transcript. Další informace o preferenční proměnné $Transcript naleznete v části about_Preference_Variables.
Příklad 4: Spuštění přepisu pomocí relativní cesty v systémech Windows
Pokud použijete relativní cestu s parametrem OutputDirectory ve Windows, cesta je relativní vzhledem k vašemu Documents adresáři.
Start-Transcript -Path .\transcripts
Transcript started, output file is C:\Users\username\Documents\.\transcripts\PowerShell_transcript.HOSTNAME.8S6RpEfN.20251105152247.txt
Příklad 5: Spuštění přepisu pomocí relativní cesty v systémech mimo Windows
Pokud použijete relativní cestu s parametrem OutputDirectory v systémech mimo Windows, cesta je relativní vzhledem k vašemu domovskému adresáři.
Start-Transcript -Path ./transcripts
Transcript started, output file is /home/username/./transcripts/PowerShell_transcript.hostname.ift21QeV.20251105151236.txt
Parametry
-Append
Označuje, že tato rutina přidá nový přepis na konec existujícího souboru. K zadání souboru použijte parametr Path.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Umožňuje rutině připojit přepis k existujícímu souboru jen pro čtení. Při použití v souboru jen pro čtení změní rutina oprávnění k souboru pro čtení i zápis. Rutina nemůže přepsat omezení zabezpečení při použití tohoto parametru.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-IncludeInvocationHeader
Označuje, že tato rutina zaznamená časové razítko při spuštění příkazů.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje umístění souboru přepisu. Na rozdíl od parametru Path se hodnota parametru LiteralPath používá přesně tak, jak je zadaný. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky informují PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
Sady parametrů
ByLiteralPath
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-NoClobber
Označuje, že tato rutina nepřepíše existující soubor. Ve výchozím nastavení, pokud soubor přepisu existuje v zadané cestě, Start-Transcript přepíše soubor bez upozornění.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | NoOverwrite |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-OutputDirectory
Určuje konkrétní cestu a složku, do které se má uložit přepis. PowerShell automaticky přiřadí název přepisu. Pokud používáte relativní cestu, je cesta relativní vzhledem k vašemu Documents adresáři ve Windows. V Linuxu a macOS je cesta relativní vzhledem k vašemu domovskému adresáři.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByOutputDirectory
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje umístění souboru přepisu. Zadejte cestu k souboru .txt. Zástupné cardy nejsou povolené. Pokud některý z adresářů v cestě neexistuje, příkaz selže.
Pokud nezadáte cestu, Start-Transcript použije cestu v hodnotě $Transcript globální proměnné. Pokud jste tuto proměnnou nevytvořili, Start-Transcript uloží přepisy do výchozího umístění a názvu souboru.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByPath
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-UseMinimalHeader
Předsadili jsme krátkou hlavičku k přepisu místo podrobné hlavičky, která je ve výchozím nastavení zahrnutá. Tento parametr byl přidán v PowerShellu 6.2.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Do tohoto cmdletu nemůžete předávat objekty.
Výstupy
String
Tato rutina vrátí řetězec obsahující potvrzovací zprávu a cestu k výstupnímu souboru.
Poznámky
Pokud chcete zastavit přepis, použijte rutinu Stop-Transcript.
Pokud chcete nahrát celou relaci, přidejte do svého profilu příkaz Start-Transcript. Další informace najdete v tématu about_Profiles.
