Server : Apache/2.4.43 (Win64) OpenSSL/1.1.1g PHP/7.4.6 System : Windows NT USER-PC 6.1 build 7601 (Windows 7 Professional Edition Service Pack 1) AMD64 User : User ( 0) PHP Version : 7.4.6 Disable Function : NONE Directory : C:/Windows/SysWOW64/WindowsPowerShell/v1.0/zh-TW/ |
<?xml version="1.0" encoding="utf-8"?> <helpItems schema="maml"> <!-- v 1.1.0.9 --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name> Start-Transcript </command:name> <maml:description> <maml:para>在文字檔中建立全部或部分 Windows PowerShell 工作階段的記錄。</maml:para> </maml:description> <maml:copyright> <maml:para></maml:para> </maml:copyright> <command:verb>Start</command:verb> <command:noun>Transcript</command:noun> <dev:version></dev:version> </command:details> <maml:description> <maml:para>Start-Transcript Cmdlet 會在文字檔中建立所有或部分 Windows PowerShell 工作階段的記錄。這份記錄 (Transcript,以下稱轉譯碼) 包括使用者輸入的所有命令以及主控台上出現的所有輸出。</maml:para> </maml:description> <!-- Cmdlet syntax section--> <command:syntax> <command:syntaxItem> <maml:name>Start-Transcript</maml:name> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>指定轉譯檔的位置。輸入 .txt 檔案的路徑。不允許使用萬用字元。 若未指定路徑,Start-Transcript 將使用 $Transcript 全域變數的值所指定的路徑。如果尚未建立該變數,Start-Transcript 會將轉譯碼儲存成 $Home\My Documents 目錄下的 \PowerShell_transcript.<時間戳記>.txt 檔案。 若路徑中指定的目錄不存在,命令便會失敗。</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">string</command:parameterValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Append</maml:name> <maml:description> <maml:para>將新轉譯碼附加至現有檔案結尾。使用 Path 參數指定檔案。</maml:para> </maml:description> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Force</maml:name> <maml:description> <maml:para>允許此 Cmdlet 將轉譯碼附加至現有的唯讀檔案。在唯讀檔案上使用時,此 Cmdlet 會將檔案權限變更為可讀寫。即便使用 Force 參數,此 Cmdlet 也無法覆寫安全性限制。</maml:para> </maml:description> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoClobber</maml:name> <maml:description> <maml:para>不覆寫 (取代) 現有檔案的內容。根據預設,如果有轉譯檔現存於指定的路徑,Start-Transcript 將覆寫該檔案而不顯示警告。</maml:para> </maml:description> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named"> <maml:name>Confirm</maml:name> <maml:description> <maml:para>在執行命令前先提示確認。</maml:para> </maml:description> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named"> <maml:name>WhatIf</maml:name> <maml:description> <maml:para>說明執行命令時將會發生何種情況,但不會實際執行命令。</maml:para> </maml:description> </command:parameter> </command:syntaxItem> </command:syntax> <!-- Cmdlet parameter section --> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Append</maml:name> <maml:description> <maml:para>將新轉譯碼附加至現有檔案結尾。使用 Path 參數指定檔案。</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Force</maml:name> <maml:description> <maml:para>允許此 Cmdlet 將轉譯碼附加至現有的唯讀檔案。在唯讀檔案上使用時,此 Cmdlet 會將檔案權限變更為可讀寫。即便使用 Force 參數,此 Cmdlet 也無法覆寫安全性限制。</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoClobber</maml:name> <maml:description> <maml:para>不覆寫 (取代) 現有檔案的內容。根據預設,如果有轉譯檔現存於指定的路徑,Start-Transcript 將覆寫該檔案而不顯示警告。</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="1"> <maml:name>Path</maml:name> <maml:description> <maml:para>指定轉譯檔的位置。輸入 .txt 檔案的路徑。不允許使用萬用字元。 若未指定路徑,Start-Transcript 將使用 $Transcript 全域變數的值所指定的路徑。如果尚未建立該變數,Start-Transcript 會將轉譯碼儲存成 $Home\My Documents 目錄下的 \PowerShell_transcript.<時間戳記>.txt 檔案。 若路徑中指定的目錄不存在,命令便會失敗。</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">string</command:parameterValue> <dev:type> <maml:name>string</maml:name> <maml:uri/> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named"> <maml:name>Confirm</maml:name> <maml:description> <maml:para>在執行命令前先提示確認。</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue/> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="false" position="named"> <maml:name>WhatIf</maml:name> <maml:description> <maml:para>說明執行命令時將會發生何種情況,但不會實際執行命令。</maml:para> </maml:description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri/> </dev:type> <dev:defaultValue/> </command:parameter> </command:parameters> <!-- Input - Output section--> <command:inputTypes> <command:inputType> <dev:type> <maml:name>無</maml:name> <maml:uri/> <maml:description/> </dev:type> <maml:description> <maml:para> <!-- description --> 您無法經由管道將物件輸出至這個 Cmdlet。 </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri/> <maml:description/> </dev:type> <maml:description> <maml:para> <!-- description --> Start-Transcript 會傳回字串,其中包含確認訊息以及輸出檔案的路徑。 </maml:para> </maml:description> </command:returnValue> </command:returnValues> <!-- Error section--> <command:terminatingErrors/> <command:nonTerminatingErrors/> <!-- Notes section --> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para> 若要停止轉譯,請使用 Stop-Transcript Cmdlet。 若要記錄整個工作階段,請將 Start-Transcript 命令加入至設定檔。如需詳細資訊,請參閱 about_Profiles。 </maml:para> </maml:alert> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <!-- Example section --> <command:examples> <command:example> <maml:title> -------------------------- 範例 1 -------------------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> </maml:introduction> <dev:code> start-transcript </dev:code> <dev:remarks> <maml:para>描述</maml:para> <maml:para>-----------</maml:para> <maml:para>這個命令在預設檔案位置中啟動轉譯。</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText></command:commandText> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title> -------------------------- 範例 2 -------------------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> </maml:introduction> <dev:code> start-transcript -path c:\transcripts\transcript0.txt -noclobber </dev:code> <dev:remarks> <maml:para>描述</maml:para> <maml:para>-----------</maml:para> <maml:para>這個命令啟動轉譯,以在 C:\transcripts 的 Transcript0.txt 檔案中建立記錄。NoClobber 參數可避免覆寫任何現有的檔案。如果 Transcript0.txt 檔案已經存在,命令會失敗。</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText></command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <!-- Link section --> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Online version:</maml:linkText> <maml:uri>http://go.microsoft.com/fwlink/?LinkID=113408</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Stop-Transcript</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- v 1.1.0.9 --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name> Stop-Transcript </command:name> <maml:description> <maml:para>停止轉譯。</maml:para> </maml:description> <maml:copyright> <maml:para></maml:para> </maml:copyright> <command:verb>Stop</command:verb> <command:noun>Transcript</command:noun> <dev:version></dev:version> </command:details> <maml:description> <maml:para>Stop-Transcript Cmdlet 會停止使用 Start-Transcript Cmdlet 所啟動的轉譯。您也可以結束工作階段來停止轉譯。</maml:para> </maml:description> <!-- Cmdlet syntax section--> <command:syntax> <command:syntaxItem> <maml:name>Stop-Transcript</maml:name> </command:syntaxItem> </command:syntax> <!-- Cmdlet parameter section --> <command:parameters> </command:parameters> <!-- Input - Output section--> <command:inputTypes> <command:inputType> <dev:type> <maml:name>無</maml:name> <maml:uri/> <maml:description/> </dev:type> <maml:description> <maml:para> <!-- description --> 您無法經由管道將輸入輸出至這個 Cmdlet。 </maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri/> <maml:description/> </dev:type> <maml:description> <maml:para> <!-- description --> Stop-Transcript 會傳回字串,其中包含狀態訊息以及輸出檔案的路徑。 </maml:para> </maml:description> </command:returnValue> </command:returnValues> <!-- Error section--> <command:terminatingErrors/> <command:nonTerminatingErrors/> <!-- Notes section --> <maml:alertSet> <maml:title></maml:title> <maml:alert> <maml:para> 如果轉譯尚未啟動,命令會失敗。 </maml:para> </maml:alert> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <!-- Example section --> <command:examples> <command:example> <maml:title> -------------------------- 範例 1 -------------------------- </maml:title> <maml:introduction> <maml:para>C:\PS></maml:para> </maml:introduction> <dev:code> stop-transcript </dev:code> <dev:remarks> <maml:para>描述</maml:para> <maml:para>-----------</maml:para> <maml:para>這個命令會停止任何正在執行的轉譯。</maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para></maml:para> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText></command:commandText> </command:commandLine> </command:commandLines> </command:example> </command:examples> <!-- Link section --> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Online version:</maml:linkText> <maml:uri>http://go.microsoft.com/fwlink/?LinkID=113415</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Start-Transcript</maml:linkText> <maml:uri/> </maml:navigationLink> </maml:relatedLinks> </command:command> </helpItems>