NAME
Start-Transcript
SYNOPSIS
Creates a record of all or part of a Windows PowerShell session in a text file.
SYNTAX
Start-Transcript [[-Path] <String>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Start-Transcript [[-LiteralPath] <String>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>
]
DESCRIPTION
The Start-Transcript cmdlet creates a record of all or part of a Windows PowerShell session in a text file. The tra
nscript includes all command that the user types and all output that appears on the console.
PARAMETERS
-Append [<SwitchParameter>]
Adds the new transcript to the end of an existing file. Use the Path parameter to specify the file.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Force [<SwitchParameter>]
Allows the cmdlet to append the transcript to an existing read-only file. When used on a read-only file, the cm
dlet changes the file permission to read-write. Even using the Force parameter, the cmdlet cannot override secu
rity restrictions.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-NoClobber [<SwitchParameter>]
Will not overwrite (replace the contents) of an existing file. By default, if a transcript file exists in the s
pecified path, Start-Transcript overwrites the file without warning.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Path <String>
Specifies a location for the transcript file. Enter a path to a .txt file. Wildcards are not permitted.
If you do not specify a path, Start-Transcript uses the path in the value of the $Transcript global variable. I
f you have not created this variable, Start-Transcript stores the transcripts in the $Home\My Documents directo
ry as \PowerShell_transcript.<time-stamp>.txt files.
If any of the directories in the path do not exist, the command fails.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-LiteralPath <String>
Specifies a location for the transcript file. Unlike Path, the value of the LiteralPath parameter is used exact
ly as it is typed. No characters are interpreted as wildcards. If the path includes escape characters, enclose
it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as
escape sequences.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
You cannot pipe objects to this cmdlet.
OUTPUTS
System.String
Start-Transcript returns a string that contains a confirmation message and the path to the output file.
NOTES
To stop a transcript, use the Stop-Transcript cmdlet.
To record an entire session, add the Start-Transcript command to your profile. For more information, see about_
Profiles.
-------------------------- EXAMPLE 1 --------------------------
PS C:\>start-transcript
This command starts a transcript in the default file location.
-------------------------- EXAMPLE 2 --------------------------
PS C:\>start-transcript -path c:\transcripts\transcript0.txt -noclobber
This command starts a transcript in the Transcript0.txt file in C:\transcripts. The NoClobber parameter prevents an
y existing files from being overwritten. If the Transcript0.txt file already exists, the command fails.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?linkid=289793
Stop-Transcript