Start-Transcript

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。

C:\PS>start-transcript

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

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

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

Stop-Transcript