Start-Transcript

参考

模块:: Microsoft.PowerShell.Host

创建指向文本文件的 PowerShell 会话的所有或部分的记录。

语法

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 编码。

示例

示例 1：使用默认设置启动脚本文件

Start-Transcript

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

示例 2：在特定位置启动脚本文件

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

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

示例 3：使用唯一名称启动脚本文件并将其存储在文件共享上

以下示例创建一个脚本文件，该文件的名称唯一，足以存储在共享位置。文件名基于用户名、运行 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。

参数

-Append

指示此 cmdlet 将新脚本添加到现有文件的末尾。使用 Path 参数指定文件。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

允许 cmdlet 将脚本追加到现有的只读文件。在只读文件上使用时，cmdlet 会将文件权限更改为读写。使用此参数时，cmdlet 无法替代安全限制。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IncludeInvocationHeader

指示此 cmdlet 在运行命令时记录时间戳。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LiteralPath

指定脚本文件的位置。与 Path 参数不同，LiteralPath 参数的值与类型化完全相同。不会将任何字符解释为通配符。如果路径包含转义字符，请将它括在单引号中。单引号通知 PowerShell 不要将任何字符解释为转义序列。

类型:	String
别名:	PSPath, LP
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoClobber

指示此 cmdlet 不会覆盖现有文件。默认情况下，如果指定路径中存在脚本文件，Start-Transcript 覆盖该文件而不发出警告。

类型:	SwitchParameter
别名:	NoOverwrite
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OutputDirectory

指定要在其中保存脚本的特定路径和文件夹。 PowerShell 会自动分配脚本名称。

类型:	String
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

指定脚本文件的位置。输入 .txt 文件的路径。不允许通配符。如果路径中的任何目录不存在，命令将失败。

如果未指定路径，Start-Transcript 将使用 $Transcript 全局变量的值中的路径。如果尚未创建此变量，Start-Transcript 将脚本存储在默认位置和文件名中。

类型:	String
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseMinimalHeader

在脚本前面添加一个简短的标头，而不是默认包含的详细标头。此参数已在 PowerShell 6.2 中添加。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

String

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

备注

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

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

通过