Dela via

Start-Transcript

  • Referens
Modul:
Microsoft.PowerShell.Host

Skapar en post för hela eller en del 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 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 en bom (Byte Order Mark) Start-Transcript används standardkodning Utf8NoBom 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 avskriftsfil 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 avskriftsfil med ett unikt namn och lagra den på en filresurs

I följande exempel skapas en avskriftsfil med ett namn som är tillräckligt unikt för att lagras på en delad plats. Filnamnet konstrueras 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 $Transcript 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 Sökväg för att ange filen.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-IncludeInvocationHeader

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 inom enkla citattecken. Enkla citattecken informerar PowerShell om att inte tolka några tecken som escape-sekvenser.

Type:String
Aliases:PSPath, LP
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Start-Transcript skriver du som standard över filen utan förvarning.

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

-OutputDirectory

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

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

-Path

Anger en plats för avskriftsfilen. Ange en sökväg till en .txt fil. Jokertecken tillåts inte. 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.

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

-UseMinimalHeader

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 i Start-Transcript din profil. Mer information finns i about_Profiles.