共用方式為

Write-Verbose

  • 參考
模組:
Microsoft.PowerShell.Utility

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

語法

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

Description

Write-Verbose Cmdlet 會將文字寫入 Windows PowerShell 中的詳細資訊訊息數據流。 一般而言，詳細資訊訊息數據流是用來傳遞用於偵錯命令之命令處理的相關信息。

根據預設，不會顯示詳細資訊訊息數據流，但您可以在任何命令中變更 $VerbosePreference 變數的值或使用 Verbose common 參數來顯示它。

範例

範例 1：寫入狀態消息

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

這些命令會使用 Write-Verbose Cmdlet 來顯示狀態消息。 根據預設，不會顯示訊息。

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

範例 2：設定$VerbosePreference並寫入狀態消息

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

這些命令會使用 Write-Verbose Cmdlet 來顯示狀態消息。 根據預設，不會顯示訊息。

第一個命令會將 [繼續] 值指派給$VerbosePreference喜好設定變數。 預設值 SilentlyContinue 會隱藏詳細資訊訊息。 第二個命令會寫入詳細資訊訊息。

參數

-Message

指定要顯示的訊息。 這是必要參數。 您也可以使用管線將訊息字串傳送至 Write-Verbose。

類型:String
別名:Msg
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

String

您可以使用管線將包含訊息的字串傳送至 Write-Verbose。

輸出

None

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

備註

  • 只有當命令使用 Verbose 一般參數時，才會傳回詳細資訊訊息。 如需詳細資訊，請參閱 about_CommonParameters。
  • 在 Windows PowerShell 背景工作和遠端命令中，作業工作和遠端作業階段中的 $VerbosePreference 變數會決定預設是否顯示詳細訊息訊息。 如需 $VerbosePreference 變數的詳細資訊，請參閱 about_Preference_Variables。