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

De cmdlet Start-Transcript maakt een record van alle of een deel van een PowerShell-sessie naar een tekstbestand. Het transcript bevat alle opdrachten die de gebruiker typt en alle uitvoer die op de console wordt weergegeven.

Standaard slaat Start-Transcript het transcript op de volgende locatie op met behulp van de standaardnaam:

• In Windows: $HOME\Documents
• In Linux of macOS: $HOME

De standaardbestandsnaam is PowerShell_transcript.<computername>.<random>.<timestamp>.txt.

Vanaf Windows PowerShell 5.0 bevat Start-Transcript de hostnaam in de gegenereerde bestandsnaam van alle transcripties. De bestandsnaam bevat ook willekeurige tekens in namen om potentiële overschrijven of duplicatie te voorkomen wanneer u twee of meer transcripties tegelijk start. Het opnemen van de computernaam is handig als u uw transcripties op een centrale locatie opslaat. De tekenreeks voor willekeurige tekens voorkomt dat de bestandsnaam onbevoegde toegang krijgt tot het bestand.

Als het doelbestand geen Byte Order Mark (BOM) heeft, Start-Transcript standaard Utf8NoBom codering in het doelbestand.

Start-Transcript

Met deze opdracht wordt een transcriptie gestart op de standaardbestandslocatie.

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

Met deze opdracht wordt een transcriptie gestart in het Transcript0.txt bestand in C:\transcripts. parameter NoClobber voorkomt dat bestaande bestanden worden overschreven. Als het Transcript0.txt bestand al bestaat, mislukt de opdracht.

In het volgende voorbeeld wordt een transcriptbestand gemaakt met een naam die uniek genoeg is om op te slaan op een gedeelde locatie. De bestandsnaam is samengesteld uit de naam van de gebruiker, de hostnaam van de computer met PowerShell, de versie van PowerShell en de datum en tijd. De transcriptie wordt opgeslagen in de \\Server01\Transcripts bestandsshare.

$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

Het volledige pad naar het transcriptiebestand wordt opgeslagen in de $Transcript voorkeursvariabele. Zie $Transcriptvoor meer informatie over de voorkeursvariabele.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert een tekenreeks met een bevestigingsbericht en het pad naar het uitvoerbestand.

Gebruik de cmdlet Stop-Transcript om een transcriptie te stoppen.

Als u een volledige sessie wilt opnemen, voegt u de opdracht Start-Transcript toe aan uw profiel. Zie about_Profilesvoor meer informatie.