Sdílet prostřednictvím

Start-Transcript

  • Reference
Modul:
Microsoft.PowerShell.Host

Vytvoří záznam celé relace PowerShellu nebo jeho části s textovým souborem.

Syntaxe

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

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).ToString()
Start-Transcript

Úplná cesta k souboru přepisu je uložená v proměnné předvoleb $Transcript. Další informace o proměnné předvoleb $Transcript naleznete v tématu about_Preference_Variables.

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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IncludeInvocationHeader

Označuje, že tato rutina zaznamená časové razítko při spuštění příkazů.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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é znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky informují PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.

Typ:String
Aliasy:PSPath, LP
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:SwitchParameter
Aliasy:NoOverwrite
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit 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.