Start-Transcript

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

Beschreibung

Das Start-Transcript Cmdlet erstellt einen Datensatz aller oder eines Teils einer PowerShell-Sitzung in einer Textdatei. Die Aufzeichnung enthält alle Befehle, die der Benutzer eingibt, und alle Ausgaben, die auf der Konsole angezeigt werden.

Speichert das Transkript standardmäßig Start-Transcript am folgenden Speicherort unter Verwendung des Standardnamens:

• Windows: $HOME\Documents
• Unter Linux oder macOS: $HOME

Der Standarddateiname lautet PowerShell_transcript.<computername>.<random>.<timestamp>.txt.

Ab Windows PowerShell 5.0 Start-Transcript enthält der Hostname im generierten Dateinamen aller Transkriptionen. Der Dateiname enthält auch zufällige Zeichen in Namen, um potenzielle Überschreibungen oder Duplizierungen zu verhindern, wenn Sie zwei oder mehr Transkriptionen gleichzeitig starten. Das Einschließen des Computernamens ist nützlich, wenn Sie Ihre Transkripte an einem zentralen Ort speichern. Die zufällige Zeichenfolge verhindert das Erraten des Dateinamens, um nicht autorisierten Zugriff auf die Datei zu erhalten.

Wenn die Zieldatei nicht über ein Bytereihenfolgenzeichen (Byte Order Mark, BOM) verfügt, Start-Transcript wird Utf8NoBom standardmäßig die Codierung in der Zieldatei festgelegt.

Beispiele

Beispiel 1: Starten einer Transkriptdatei mit Standardeinstellungen

Start-Transcript

Dieser Befehl startet eine Aufzeichnung am Standarddateispeicherort.

Beispiel 2: Starten einer Transkriptdatei an einem bestimmten Speicherort

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

Dieser Befehl startet eine Transkription in der Transcript0.txt Datei in C:\transcripts. NoClobber-Parameter verhindert, dass vorhandene Dateien überschrieben werden. Wenn die Transcript0.txt Datei bereits vorhanden ist, schlägt der Befehl fehl.

Beispiel 3: Starten einer Transkriptdatei mit einem eindeutigen Namen und Speichern in einer Dateifreigabe

Im folgenden Beispiel wird eine Transkriptdatei mit einem Namen erstellt, der eindeutig genug ist, um an einem freigegebenen Speicherort gespeichert zu werden. Der Dateiname wird aus dem Namen des Benutzers, dem Hostnamen des Computers mit PowerShell, der Version von PowerShell und dem Datum und der Uhrzeit erstellt. Das Transkript wird in der \\Server01\Transcripts Dateifreigabe gespeichert.

$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

Der vollständige Pfad zur Transkriptdatei wird in der $Transcript Einstellungsvariable gespeichert. Weitere Informationen zur Einstellungsvariablen $Transcript finden Sie unter about_Preference_Variables.

Parameter

-Append

-Confirm

-Force

-IncludeInvocationHeader

-LiteralPath

-NoClobber

-OutputDirectory

-Path

-UseMinimalHeader

-WhatIf

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

String

Dieses Cmdlet gibt eine Zeichenfolge mit einer Bestätigungsmeldung und dem Pfad zur Ausgabedatei zurück.

Hinweise

Verwenden Sie das Stop-Transcript Cmdlet, um ein Transkript zu beenden.

Um eine gesamte Sitzung aufzuzeichnen, fügen Sie den Start-Transcript Befehl zu Ihrem Profil hinzu. Weitere Informationen finden Sie unter about_Profiles.

Ähnliche Themen

• Stop-Transcript
• about_Preference_Variables