Write-Verbose
將文字寫入詳細資訊訊息串流。
Syntax
Write-Verbose
[-Message] <String>
[<CommonParameters>]
Description
Cmdlet 會在 Write-Verbose
PowerShell 中將文字寫入詳細資訊訊息數據流。 一般而言,詳細資訊訊息數據流是用來提供更深入的命令處理資訊。
根據預設,不會顯示詳細資訊訊息數據流,但您可以變更變數的值 $VerbosePreference
,或在任何命令中使用 Verbose 通用參數來顯示它。
範例
範例 1:寫入狀態消息
Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose
這些命令會 Write-Verbose
使用 Cmdlet 來顯示狀態消息。 根據預設,不會顯示訊息。
第二個命令會使用 Verbose 通用參數,不論變數的值 $VerbosePreference
為何,都會顯示任何詳細資訊訊息。
範例 2:設定$VerbosePreference並寫入狀態消息
$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"
這些命令會 Write-Verbose
使用 Cmdlet 來顯示狀態消息。 根據預設,不會顯示訊息。
第一個命令會將 [繼續] 的值指派給 $VerbosePreference
喜好設定變數。 預設值 SilentlyContinue
會隱藏詳細資訊訊息。 第二個命令寫入詳細資訊訊息。
參數
-Message
指定要顯示的訊息。 此為必要參數。 您也可以使用管線將訊息字串傳送至 Write-Verbose
。
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸入
您可以使用管線將包含訊息的字串傳送至 Write-Verbose
。
輸出
None
Write-Verbose
只會寫入詳細資訊訊息數據流。
備註
- 只有在此命令使用 Verbose 一般參數時,才會傳回詳細資訊訊息。 如需詳細資訊,請參閱 about_CommonParameters。
- 在 Windows PowerShell 背景作業和遠端命令中
$VerbosePreference
,作業會話和遠端會話中的變數預設會判斷是否顯示詳細資訊訊息。 如需變數的詳細資訊$VerbosePreference
,請參閱 about_Preference_Variables。