Write-Verbose

模組:
Microsoft.PowerShell.Utility Module

將文字寫入冗長的訊息串流。

語法

Default (預設值) 

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

Description

Write-Verbose指令長會將文字寫入 PowerShell 的冗長訊息串流。 通常，冗長訊息流用於傳遞更深入的指令處理資訊。

預設情況下，verbose 訊息串流不會顯示，但你可以透過改變變數值 $VerbosePreference 或在任何指令中使用 Verbose common 參數來顯示。

範例

範例 1：撰寫狀態訊息

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

這些指令使用 Write-Verbose cmdlet 來顯示狀態訊息。 預設情況下，訊息不會顯示。

第二個指令使用 Verbose common 參數，無論變數值 $VerbosePreference 為何，都會顯示任何冗長訊息。

範例 2：設定 $VerbosePreference 並撰寫狀態訊息

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

這些指令使用 Write-Verbose cmdlet 來顯示狀態訊息。 預設情況下，訊息不會顯示。

第一個指令會為偏好變數指派一個 Continue $VerbosePreference 值。 預設值 SilentlyContinue，則抑制冗長訊息。 第二個指令則寫出冗長訊息。

參數

-Message

指定要顯示的訊息。 此為必要參數。 你也可以將訊息串管道接到 Write-Verbose。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:味精

參數集

(All)
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

你可以把包含訊息的字串傳到這個 cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。 它只會寫入冗長訊息流。

備註

  • 只有當指令使用 Verbose common 參數時， Verbose 訊息才會回傳。 如需詳細資訊，請參閱 about_CommonParameters。
  • 在 Windows PowerShell 背景工作與遠端指令中，工作會話與遠端會話中的 $VerbosePreference 變數決定是否預設顯示冗長訊息。 如需 $VerbosePreference 變數的詳細資訊，請參閱 about_Preference_Variables。