Erstellt eine Aufzeichnung einer gesamten oder teilweisen Windows PowerShell-Sitzung in einer Textdatei.
Syntax
Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "Start-Transcript" erstellt eine Aufzeichnung einer gesamten oder teilweisen Windows PowerShell-Sitzung in einer Textdatei. Die Aufzeichnung enthält alle vom Benutzer eingegebenen Befehle sowie die gesamte in der Konsole angezeigte Ausgabe.
Parameter
-Append
Fügt die neue Aufzeichnung am Ende einer vorhandenen Datei hinzu. Verwenden Sie den Path-Parameter, um die Datei anzugeben.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Ermöglicht es dem Cmdlet, die Aufzeichnung an eine vorhandene schreibgeschützte Datei anzufügen. Bei Verwendung in einer schreibgeschützten Datei ändert das Cmdlet die Dateiberechtigung in Lese-/Schreibzugriff. Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-NoClobber
Gibt an, dass eine vorhandene Datei nicht überschrieben (d. h. ihr Inhalt ersetzt) wird. Standardmäßig wird mit Start-Transcript eine unter dem angegebenen Pfad vorhandene Aufzeichnungsdatei ohne vorherige Warnung überschrieben.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string>
Gibt einen Speicherort für die Aufzeichnungsdatei an. Geben Sie den Pfad zu einer TXT-Datei ein. Platzhalter sind nicht zulässig.
Wenn Sie keinen Pfad angeben, verwendet Start-Transcript den Pfad im Wert der globalen Variablen "$Transcript". Wenn Sie diese Variable nicht erstellt haben, speichert Start-Transcript die Aufzeichnungen im Verzeichnis "$Home\Eigene Dateien" als Dateien mit dem Namen "\PowerShell_transcript.<Zeitstempel>.txt".
Wenn eines der Verzeichnisse im Pfad nicht vorhanden ist, verursacht der Befehl einen Fehler.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Objekte können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
|
Ausgaben |
System.String Start-Transcript gibt eine Zeichenfolge, die eine Bestätigungsmeldung und den Pfad enthält, an die Ausgabedatei zurück. |
Hinweise
Zum Beenden einer Aufzeichnung verwenden Sie das Cmdlet "Stop-Transcript".
Zum Aufzeichnen einer gesamten Sitzung fügen Sie Ihrem Profil den Befehl "Start-Transcript" hinzu. Weitere Informationen finden Sie unter "about_Profiles".
Beispiel 1
C:\PS>start-transcript Beschreibung ----------- Mit diesem Befehl wird eine Aufzeichnung am Standard-Dateispeicherort gestartet.
Beispiel 2
C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber Beschreibung ----------- Mit diesem Befehl wird eine Aufzeichnung unter "C:\transcripts" in der Datei "Transcript0.txt" gestartet. Durch den NoClobber-Parameter wird verhindert, dass vorhandene Dateien überschrieben werden. Wenn die Datei "Transcript0.txt" bereits vorhanden ist, verursacht der Befehl einen Fehler.
Siehe auch