Write-Verbose

  • 参考
模块:
Microsoft.PowerShell.Utility

将文本写入详细消息流。

语法

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

说明

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 显示状态消息。 默认情况下，不显示此消息。

第一个命令将值 Continue 分配给 $VerbosePreference 首选项变量。 默认值 SilentlyContinue禁止显示详细消息。 第二个命令写入详细消息。

参数

-Message

指定要显示的消息。 此参数是必需的。 还可以通过管道将消息字符串传递给 Write-Verbose。

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

String

可以通过管道将包含消息的字符串传递给 Write-Verbose。

输出

None

Write-Verbose 仅写入详细消息流。

备注

  • 仅在该命令使用 Verbose 通用参数时才返回详细消息。 有关详细信息，请参阅 about_CommonParameters。
  • 在Windows PowerShell后台作业和远程命令中$VerbosePreference，作业会话和远程会话中的 变量确定是否默认显示详细消息。 有关 变量的详细信息 $VerbosePreference ，请参阅 about_Preference_Variables。