The $InformationPreference preference variable value determines whether the message you provide to
value of $InformationPreference, you can override its value by adding the InformationAction common parameter to
your command. For more information, see about_Preference_Variables and about_CommonParameters.
emit output to the information stream, but the $InformationPreference preference variable and InformationAction
common parameter do not affect Write-Host messages. Information streams also work for PowerShell.Streams , jobs,
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Write-Information does not accept piped input.
OUTPUTS
System.Management.Automation.InformationRecord
NOTES
Example 1: Write information for Get- results
PS C:\>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!
In this example, you show an informational message, "Got your features!", after running the Get-WindowsFeature
command to find all features that have a Name value that starts with p. Because the $InformationPreference
variable is still set to its default, SilentlyContinue, you add the InformationAction parameter to override the
$InformationPreference value, and show the message. The InformationAction value is Continue, which means that your
message is shown, but the script or command continues, if it is not yet finished.
Example 2: Write information and tag it
PS C:\>Get-WindowsFeature -Name p*; Write-Information -MessageData "To filter your results for PowerShell, pipe
your results to the Where-Object cmdlet." -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.
In this example, you use Write-Information to let users know they'll need to run another command after they're
done running the current command. The example adds the tag Instructions to the informational message. After
running this command, if you search the information stream for messages tagged Instructions, the message specified
here would be among the results.
Example 3: Write information to a file
PS C:\>function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txt
In this example, you redirect the information stream in the function to a file, Info.txt, by using the code 6>.
When you open the Info.txt file, you see the text, "Here you go."
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821877
about_CommonParameters
about_Preference_Variables
about_Redirection
Write-Debug
Write-Host
Write-Information
Write-Progress
Write-Verbose
Write-Warning
Write-Output