在文字檔中建立全部或部分 Windows PowerShell 工作階段的記錄。

語法

Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Start-Transcript Cmdlet 會在文字檔中建立所有或部分 Windows PowerShell 工作階段的記錄。這份記錄 (Transcript,以下稱轉譯碼) 包括使用者輸入的所有命令以及主控台上出現的所有輸出。

參數

-Append

將新轉譯碼附加至現有檔案結尾。使用 Path 參數指定檔案。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Force

允許此 Cmdlet 將轉譯碼附加至現有的唯讀檔案。在唯讀檔案上使用時,此 Cmdlet 會將檔案權限變更為可讀寫。即便使用 Force 參數,此 Cmdlet 也無法覆寫安全性限制。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-NoClobber

不覆寫 (取代) 現有檔案的內容。根據預設,如果有轉譯檔現存於指定的路徑,Start-Transcript 將覆寫該檔案而不顯示警告。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Path <string>

指定轉譯檔的位置。輸入 .txt 檔案的路徑。不允許使用萬用字元。

若未指定路徑,Start-Transcript 將使用 $Transcript 全域變數的值所指定的路徑。如果尚未建立該變數,Start-Transcript 會將轉譯碼儲存成 $Home\My Documents 目錄下的 \PowerShell_transcript.<時間戳記>.txt 檔案。

若路徑中指定的目錄不存在,命令便會失敗。

必要?

false

位置?

1

預設值

接受管線輸入?

false

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

您無法經由管道將物件輸出至這個 Cmdlet。

輸出

System.String

Start-Transcript 會傳回字串,其中包含確認訊息以及輸出檔案的路徑。

附註

若要停止轉譯,請使用 Stop-Transcript Cmdlet。

若要記錄整個工作階段,請將 Start-Transcript 命令加入至設定檔。如需詳細資訊,請參閱 about_Profiles。

範例 1

C:\PS>start-transcript

描述
-----------
這個命令在預設檔案位置中啟動轉譯。






範例 2

C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber

描述
-----------
這個命令啟動轉譯,以在 C:\transcripts 的 Transcript0.txt 檔案中建立記錄。NoClobber 參數可避免覆寫任何現有的檔案。如果 Transcript0.txt 檔案已經存在,命令會失敗。






請參閱




目錄