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 Start-Transcript lagrar 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 Start-Transcript innehåller 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 kodas Utf8NoBom som standard 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 Transcript0.txt filen i C:\transcripts. NoClobber-parametern förhindrar att befintliga filer skrivs över. Transcript0.txt Om 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 filresursen \\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

Den fullständiga sökvägen till avskriftsfilen lagras i inställningsvariabeln $Transcript . Mer information om inställningsvariabeln finns i $Transcript 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 Sökväg 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 precis som det 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 transkriptionsfil i den angivna sökvägen Start-Transcript skriver du 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 Start-Transcript använder du sökvägen i värdet för den $Transcript globala variabeln. Om du inte har skapat den här variabeln Start-Transcript lagrar du 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ördes. 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 registrera en hel session lägger du till kommandot i Start-Transcript din profil. Mer information finns i about_Profiles.