Write-Information

参考

模块:: Microsoft.PowerShell.Utility

指定 PowerShell 如何处理命令的信息流数据。

语法

Write-Information
     [-MessageData] <Object>
     [[-Tags] <String[]>]
     [<CommonParameters>]

说明

Write-Information cmdlet 指定 PowerShell 如何处理命令的信息流数据。

Windows PowerShell 5.0 引入了新的结构化信息流。可以使用此流在脚本及其调用方或主机应用程序之间传输结构化数据。 Write-Information 允许向流添加信息性消息，并指定 PowerShell 如何处理命令的信息流数据。信息流也适用于 PowerShell.Streams、作业和计划任务。

注意

信息流不遵循使用“[流名称]：”作为消息前缀的标准约定。这是为了简洁和视觉清洁。

$InformationPreference 首选项变量值确定提供给 Write-Information 的消息是否显示在脚本操作的预期点。由于此变量的默认值 SilentlyContinue，因此默认情况下不显示信息性消息。如果不想更改 $InformationPreference的值，可以通过向命令添加 InformationAction 通用参数来替代其值。有关详细信息，请参阅 about_Preference_Variables 和 about_CommonParameters。

注意

从 Windows PowerShell 5.0 开始，Write-Host 是 Write-Information 的包装器。这允许你使用 Write-Host 向信息流发出输出。这使捕获或抑制使用 Write-Host 写入的数据，同时保持向后兼容性。有关详细信息，请参阅写主机

Write-Information 也是 PowerShell 5.x 中支持的工作流活动。

示例

示例 1：写入 Get-results 的信息

在此示例中，你将在运行 Get-WindowsFeature 命令后显示信息性消息“获取功能！”，以查找名称值以“p”开头的所有功能。由于 $InformationPreference 变量仍设置为其默认变量 SilentlyContinue，因此添加 InformationAction 参数以替代 $InformationPreference 值，并显示消息。 InformationAction 值为 Continue，这意味着消息显示，但如果尚未完成，脚本或命令将继续。

Get-WindowsFeature -Name p*
Write-Information -MessageData "Got your features!" -InformationAction Continue

Display Name                                            Name                       Install State
------------                                            ----                       -------------
[ ] Print and Document Services                         Print-Services                 Available
    [ ] Print Server                                    Print-Server                   Available
    [ ] Distributed Scan Server                         Print-Scan-Server              Available
    [ ] Internet Printing                               Print-Internet                 Available
    [ ] LPD Service                                     Print-LPD-Service              Available
[ ] Peer Name Resolution Protocol                       PNRP                           Available
[X] Windows PowerShell                                  PowerShellRoot                 Installed
    [X] Windows PowerShell 5.0                          PowerShell                     Installed
    [ ] Windows PowerShell 2.0 Engine                   PowerShell-V2                    Removed
    [X] Windows PowerShell ISE                          PowerShell-ISE                 Installed
Got your features!

示例 2：编写信息并将其标记

在此示例中，使用 Write-Information 让用户知道在运行当前命令后，他们需要运行另一个命令。该示例将标记“说明”添加到信息性消息。运行此命令后，如果在信息流中搜索标记为“说明”的消息，此处指定的消息将是结果之一。

$message = "To filter your results for PowerShell, pipe your results to the Where-Object cmdlet."
Get-WindowsFeature -Name p*
Write-Information -MessageData $message -Tags "Instructions" -InformationAction Continue

Display Name                                            Name                       Install State
------------                                            ----                       -------------
[ ] Print and Document Services                         Print-Services                 Available
    [ ] Print Server                                    Print-Server                   Available
    [ ] Distributed Scan Server                         Print-Scan-Server              Available
    [ ] Internet Printing                               Print-Internet                 Available
    [ ] LPD Service                                     Print-LPD-Service              Available
[ ] Peer Name Resolution Protocol                       PNRP                           Available
[X] Windows PowerShell                                  PowerShellRoot                 Installed
    [X] Windows PowerShell 5.0                          PowerShell                     Installed
    [ ] Windows PowerShell 2.0 Engine                   PowerShell-V2                    Removed
    [X] Windows PowerShell ISE                          PowerShell-ISE                 Installed
To filter your results for PowerShell, pipe your results to the Where-Object cmdlet.

示例 3：将信息写入文件

在此示例中，将使用代码 6>将函数中的信息流重定向到 Info.txt。打开 Info.txt 文件时，会看到文本“转到此处”。

function Test-Info
{
    Get-Process P*
    Write-Information "Here you go"
}
Test-Info 6> Info.txt

示例 4：传递对象以写入信息

在此示例中，可以使用 Write-Information 从传递多个管道的 Get-Process 对象输出中写入前 10 个最高的 CPU 使用率进程。

Get-Process | Sort-Object CPU -Descending |
    Select-Object Id, ProcessName, CPU -First 10 |
        Write-Information -InformationAction Continue

@{Id=12692; ProcessName=chrome; CPU=39431.296875}
@{Id=21292; ProcessName=OUTLOOK; CPU=23991.875}
@{Id=10548; ProcessName=CefSharp.BrowserSubprocess; CPU=20546.203125}
@{Id=312848; ProcessName=Taskmgr; CPU=13173.1875}
@{Id=10848; ProcessName=SnapClient; CPU=7014.265625}
@{Id=9760; ProcessName=Receiver; CPU=6792.359375}
@{Id=12040; ProcessName=Teams; CPU=5605.578125}
@{Id=498388; ProcessName=chrome; CPU=3062.453125}
@{Id=6900; ProcessName=chrome; CPU=2546.9375}
@{Id=9044; ProcessName=explorer; CPU=2358.765625}

参数

-MessageData

指定要在用户运行脚本或命令时向用户显示的信息性消息。为获得最佳结果，请将信息性消息括在引号中。

类型:	Object
别名:	Msg, Message
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Tags

指定一个简单的字符串，可用于使用 Write-Information对已添加到信息流的消息进行排序和筛选。此参数的工作方式类似于 New-ModuleManifest中的 Tags 参数。

类型:	String[]
Position:	1
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Object

Write-Information 接受传递给信息流的管道对象。

输出

InformationRecord

通过