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 コマンドレットは、PowerShell セッションのすべてまたは一部のレコードをテキスト ファイルに作成します。 トランスクリプトには、ユーザーが入力したすべてのコマンドと、コンソールに表示されるすべての出力が含まれます。

既定では、Start-Transcript は、既定の名前を使用して、トランスクリプトを次の場所に格納します。

• Windows の場合: $HOME\Documents
• Linux または macOS の場合: $HOME

既定のファイル名は PowerShell_transcript.<computername>.<random>.<timestamp>.txtです。

Windows PowerShell 5.0 以降では、Start-Transcript はすべてのトランスクリプトの生成されたファイル名にホスト名を含めます。 ファイル名には、2 つ以上のトランスクリプトを同時に開始するときに上書きや重複を防ぐために、名前にランダムな文字も含まれています。 コンピューター名を含めると、トランスクリプトを一元化された場所に格納する場合に便利です。 ランダムな文字列を使用すると、ファイル名を推測してファイルへの不正アクセスを取得できなくなります。

ターゲット ファイルにバイトオーダー マーク (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」を参照してください。

Windows で OutputDirectory パラメーターで相対パスを使用する場合、パスは Documents ディレクトリに対する相対パスになります。

Start-Transcript -Path .\transcripts

Transcript started, output file is C:\Users\username\Documents\.\transcripts\PowerShell_transcript.HOSTNAME.8S6RpEfN.20251105152247.txt

Windows 以外のシステムで OutputDirectory パラメーターと共に相対パスを使用する場合、パスはホーム ディレクトリに対する相対パスになります。

Start-Transcript -Path ./transcripts

Transcript started, output file is /home/username/./transcripts/PowerShell_transcript.hostname.ift21QeV.20251105151236.txt

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

このコマンドレットにオブジェクトをパイプすることはできません。

このコマンドレットは、確認メッセージと出力ファイルへのパスを含む文字列を返します。

トランスクリプトを停止するには、Stop-Transcript コマンドレットを使用します。

セッション全体を記録するには、Start-Transcript コマンドをプロファイルに追加します。 詳細については、about_Profilesを参照してください。