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

Start-Transcript cmdlet 创建指向文本文件的所有或部分 PowerShell 会话的记录。 脚本包括用户键入的所有命令以及控制台上显示的所有输出。

默认情况下，Start-Transcript 使用默认名称将脚本存储在以下位置：

• 在 Windows 上：$HOME\Documents
• 在 Linux 或 macOS 上：$HOME

默认文件名为 PowerShell_transcript.<computername>.<random>.<timestamp>.txt。

从 Windows PowerShell 5.0 开始，Start-Transcript 包括所有脚本生成的文件名中的主机名。 文件名还包含名称中的随机字符，以防止同时启动两个或多个脚本时发生覆盖或重复。 如果将脚本存储在集中位置，则包括计算机名称非常有用。 随机字符串可防止猜测文件名以获取对文件的未经授权的访问。

如果目标文件没有字节顺序标记（BOM），Start-Transcript 默认在目标文件中 Utf8NoBom 编码。

Start-Transcript

此命令在默认文件位置启动脚本。

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

此命令在 Transcript0.txt的 C:\transcripts 文件中启动脚本。 NoClobber 参数可防止覆盖任何现有文件。 如果 Transcript0.txt 文件已存在，该命令将失败。

以下示例创建一个脚本文件，该文件的名称唯一，足以存储在共享位置。 文件名基于用户名、运行 PowerShell 的计算机的主机名、PowerShell 的版本以及日期和时间构造。 脚本存储在 \\Server01\Transcripts 文件共享中。

$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

脚本文件的完整路径存储在 $Transcript 首选项变量中。 有关 $Transcript 首选项变量的详细信息，请参阅 about_Preference_Variables。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

此 cmdlet 返回一个字符串，其中包含确认消息和输出文件的路径。

若要停止脚本，请使用 Stop-Transcript cmdlet。

若要记录整个会话，请将 Start-Transcript 命令添加到配置文件。 有关详细信息，请参阅 about_Profiles。