Start-Transcript

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

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.

Start-Transcript

Det här kommandot startar en avskrift på standardfilens 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.

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.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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

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.