Write To Console PowerShell Command Reference: Syntax, Flags

write to console powershell is the operation of sending text, objects, or messages to the PowerShell host. Use Write-Output, Write-Host, or [console]::WriteLine.

Write-Output "Hello, Console"

Syntax

# Write-Output (default cmdlet – sends objects to the success stream)
Write-Output [-InputObject] <PSObject[]> [-NoEnumerate] [<CommonParameters>]

# Write-Host (writes directly to the console host, bypasses pipeline)
Write-Host [[-Object] <Object>] [-NoNewline] [-Separator <Object>] [-ForegroundColor <ConsoleColor>] [-BackgroundColor <ConsoleColor>] [<CommonParameters>]

# .NET method (low-level, only works in full console host)
[console]::WriteLine("string")

# Example of a custom logging function using Write-Output and file appending
Function Write-Log {
    param([string]$Message, [ValidateSet('Info','Warning','Error')][string]$Severity='Info')
    $timestamp = Get-Date -Format 'yyyyMMddHHmmss'
    $line = "$timestamp,$Severity,$Message"
    Write-Output $line
    if ($LogToFile) { Add-Content -Path $LogFileName -Value $line }
}

Options and Flags

Usage Examples

Example 1: Display process objects using Write-Output

$P = Get-Process -Name powershell
Write-Output $P

Outputs the process objects to the pipeline. If this is the last command, PowerShell automatically calls Out-Default to render them in the console. This method preserves object structure for further pipeline processing.

Example 2: Colored status messages with Write-Host

Write-Host "Starting deployment..." -ForegroundColor Green
# ... deployment steps ...
Write-Host "Deployment complete." -ForegroundColor Green

Write-Host bypasses the pipeline and writes directly to the host UI. Use for user-facing progress, warnings, or errors where formatting is required. Do not use when the output needs to be captured or piped to another cmdlet.

Example 3: Logging with a custom function and file output

Function Write-Log {
    param([string]$Message, [string]$Severity='Info', [switch]$LogToFile)
    $timestamp = Get-Date -Format 'yyyyMMddHHmmss'
    $line = "$timestamp,$Severity,$Message"
    Write-Output $line
    if ($LogToFile) { Add-Content -Path "C:Logsscript.log" -Value $line }
}
Write-Log -Message "Processing batch #1" -Severity Info -LogToFile

Demonstrates a structured logging approach. The Write-Output command sends the formatted log line to the success stream, while also appending it to a file if the switch is set. Avoid Write-Host in logging functions to preserve the pipeline.

Performance Considerations

For high-volume console output, batch writes using StringBuilder or redirect to a file with Out-File. Write-Output sends objects to the pipeline; Write-Host bypasses it but is slower for large data. The -NoEnumerate flag can reduce overhead when passing collections without unrolling.

Troubleshooting & Common Errors

Frequently Asked Questions

# Write-Host: no pipeline output
Write-Host "Message"

# Write-Output: passes string to pipeline
Write-Output "Data" | ForEach-Object { $_ }

# Unrolls array into two items
Write-Output @(1,2) | Measure-Object | Select-Object Count

# Sends array as single object
Write-Output -NoEnumerate @(1,2) | Measure-Object | Select-Object Count

$InformationPreference = 'Continue'
Write-Information "Info message" -InformationAction Continue

# Fastest direct console write
[Console]::WriteLine("Speed-critical message")