Delen via

Start-Transcript

  • Referentie
Module:
Microsoft.PowerShell.Host

Hiermee maakt u een record van alle of een deel van een PowerShell-sessie naar een tekstbestand.

Syntaxis

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

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.

Voorbeelden

Voorbeeld 1: Een transcriptbestand met standaardinstellingen starten

Start-Transcript

Met deze opdracht wordt een transcriptie gestart op de standaardbestandslocatie.

Voorbeeld 2: Een transcriptbestand starten op een specifieke locatie

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.

Voorbeeld 3: Een transcriptbestand met een unieke naam starten en opslaan op een bestandsshare

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 about_Preference_Variablesvoor meer informatie over de $Transcript voorkeursvariabele.

Parameters

-Append

Geeft aan dat met deze cmdlet de nieuwe transcriptie wordt toegevoegd aan het einde van een bestaand bestand. Gebruik de parameter Path om het bestand op te geven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee kan de cmdlet het transcript toevoegen aan een bestaand bestand met het kenmerk Alleen-lezen. Wanneer de cmdlet wordt gebruikt voor een bestand met het kenmerk Alleen-lezen, wordt de bestandsmachtiging gewijzigd in lezen/schrijven. De cmdlet kan geen beveiligingsbeperkingen overschrijven wanneer deze parameter wordt gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeInvocationHeader

Geeft aan dat deze cmdlet het tijdstempel registreert wanneer opdrachten worden uitgevoerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u een locatie naar het transcriptbestand. In tegenstelling tot de parameter Path, wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze wordt getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens informeren PowerShell niet om tekens als escapereeksen te interpreteren.

Type:String
Aliassen:PSPath, LP
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoClobber

Geeft aan dat deze cmdlet een bestaand bestand niet overschrijft. Als er een transcriptiebestand in het opgegeven pad bestaat, overschrijft Start-Transcript het bestand standaard zonder waarschuwing.

Type:SwitchParameter
Aliassen:NoOverwrite
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OutputDirectory

Hiermee geeft u een specifiek pad en een specifieke map op waarin een transcript moet worden opgeslagen. PowerShell wijst automatisch de transcriptnaam toe.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u een locatie naar het transcriptbestand. Voer een pad naar een .txt-bestand in. Jokertekens zijn niet toegestaan. Als een van de mappen in het pad niet bestaat, mislukt de opdracht.

Als u geen pad opgeeft, gebruikt Start-Transcript het pad in de waarde van de globale variabele $Transcript. Als u deze variabele nog niet hebt gemaakt, Start-Transcript de transcripties opslaat op de standaardlocatie en bestandsnaam.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseMinimalHeader

Maak een korte koptekst vooraf aan het transcript, in plaats van de gedetailleerde koptekst die standaard is opgenomen. Deze parameter is toegevoegd in PowerShell 6.2.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

String

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

Notities

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.