Write-Verbose
將文字寫入詳細訊息資料流。
語法
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" 會抑制詳細訊息。
第二個命令會寫入詳細訊息。