Dela via

Start-Transcript

  • Referens
Modul:
Microsoft.PowerShell.Host

Skapar en post för hela eller delar av en PowerShell-session till en textfil.

Syntax

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

Cmdleten Start-Transcript skapar en post för hela eller en del av en PowerShell-session till en textfil. Avskriften innehåller alla kommandon som användaren skriver och alla utdata som visas i konsolen.

Som standard lagrar Start-Transcript avskriften på följande plats med standardnamnet:

  • I Windows: $HOME\Documents
  • I Linux eller macOS: $HOME

Standardfilnamnet är PowerShell_transcript.<computername>.<random>.<timestamp>.txt.

Från och med Windows PowerShell 5.0 innehåller Start-Transcript värdnamnet i det genererade filnamnet för alla avskrifter. Filnamnet innehåller också slumpmässiga tecken i namn för att förhindra potentiell överskrivning eller duplicering när du startar två eller flera avskrifter samtidigt. Att inkludera datornamnet är användbart om du lagrar dina avskrifter på en central plats. Den slumpmässiga teckensträngen förhindrar att filnamnet gissas för att få obehörig åtkomst till filen.

Om målfilen inte har ett byteordningsmärke (BOM) Start-Transcript standardinställningen Utf8NoBom kodning i målfilen.

Exempel

Exempel 1: Starta en avskriftsfil med standardinställningar

Start-Transcript

Det här kommandot startar en avskrift på standardfilens plats.

Exempel 2: Starta en transkriptionsfil på en specifik plats

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

Det här kommandot startar en avskrift i filen Transcript0.txt i C:\transcripts. NoClobber parameter förhindrar att befintliga filer skrivs över. Om den Transcript0.txt filen redan finns misslyckas kommandot.

Exempel 3: Starta en transkriptionsfil med ett unikt namn och lagra den på en filresurs

I följande exempel skapas en transkriptionsfil med ett namn som är tillräckligt unikt för att lagras på en delad plats. Filnamnet skapas från användarens namn, värdnamnet för den dator som kör PowerShell, versionen av PowerShell samt datum och tid. Avskriften lagras i \\Server01\Transcripts filresurs.

$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

Den fullständiga sökvägen till avskriftsfilen lagras i $Transcript inställningsvariabeln. Mer information om $Transcript-inställningsvariabeln finns i about_Preference_Variables.

Parametrar

-Append

Anger att den här cmdleten lägger till den nya avskriften i slutet av en befintlig fil. Använd parametern Path för att ange filen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tillåter att cmdleten lägger till avskriften i en befintlig skrivskyddad fil. När den används i en skrivskyddad fil ändrar cmdleten filbehörigheten till skrivskyddad. Cmdleten kan inte åsidosätta säkerhetsbegränsningar när den här parametern används.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeInvocationHeader

Anger att den här cmdleten loggar tidsstämpeln när kommandon körs.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LiteralPath

Anger en plats för avskriftsfilen. Till skillnad från parametern Path används värdet för parametern LiteralPath exakt som den skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken informerar PowerShell om att inte tolka några tecken som escape-sekvenser.

Typ:String
Alias:PSPath, LP
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NoClobber

Anger att den här cmdleten inte skriver över en befintlig fil. Om det finns en avskriftsfil i den angivna sökvägen skriver Start-Transcript som standard över filen utan förvarning.

Typ:SwitchParameter
Alias:NoOverwrite
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OutputDirectory

Anger en specifik sökväg och mapp där en avskrift ska sparas. PowerShell tilldelar automatiskt avskriftsnamnet.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en plats för avskriftsfilen. Ange en sökväg till en .txt fil. Jokertecken är inte tillåtna. Om någon av katalogerna i sökvägen inte finns misslyckas kommandot.

Om du inte anger en sökväg använder Start-Transcript sökvägen i värdet för den $Transcript globala variabeln. Om du inte har skapat den här variabeln lagrar Start-Transcript avskrifterna på standardplatsen och filnamnet.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseMinimalHeader

Förbered en kort rubrik till avskriften i stället för den detaljerade rubriken som ingår som standard. Den här parametern lades till i PowerShell 6.2.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

String

Den här cmdleten returnerar en sträng som innehåller ett bekräftelsemeddelande och sökvägen till utdatafilen.

Kommentarer

Om du vill stoppa en avskrift använder du cmdleten Stop-Transcript.

Om du vill spela in en hel session lägger du till kommandot Start-Transcript i din profil. Mer information finns i about_Profiles.