將文字寫入詳細訊息資料流。

語法

Write-Verbose [-Message] <string> [<CommonParameters>]

描述

Write-Verbose Cmdlet 會在 Windows PowerShell 中將文字寫入詳細訊息資料流。基本上,詳細訊息資料流是用來傳遞有關命令處理的資訊,用於偵錯命令。

根據預設,雖然系統不會顯示詳細訊息資料流,不過您可以變更 $VerbosePreference 變數的值或在任何命令中使用 Verbose 一般參數,藉以顯示此資料流。

參數

-Message <string>

指定要顯示的訊息。此參數為必要項。您也可經由管道將訊息字串輸出至 Verbose-Message。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

<CommonParameters>

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

輸入和輸出

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

輸入

System.String

您可經由管道將包含訊息的字串輸出至 Write-Verbose。

輸出

Write-Verbose 只會寫入詳細訊息資料流。

範例 1

C:\PS>Write-Verbose -message "Searching the Application Event Log."

C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose

描述
-----------
這些命令會使用 Write-Verbose Cmdlet 來顯示狀態訊息。根據預設,系統不會顯示此訊息。

第二個命令會使用 Verbose 一般參數,以便顯示任何詳細訊息,不論 $VerbosePreference 變數的值為何。






範例 2

C:\PS>$VerbosePreference = "Continue"

C:\PS> Write-Verbose "Copying file $filename"

描述
-----------
這些命令會使用 Write-Verbose Cmdlet 來顯示狀態訊息。根據預設,系統不會顯示此訊息。

第一個命令會將 "Continue" 值指派給 $VerbosePreference 喜好設定變數。預設值 "SilentlyContinue" 會抑制詳細訊息。

第二個命令會寫入詳細訊息。






請參閱




目錄