Dela via

Write-Host

Modul:
Microsoft.PowerShell.Utility Module

Skriver anpassade utdata till en värd.

Syntax

Default (Standard) 

Write-Host
    [[-Object] <Object>]
    [-NoNewline]
    [-Separator <Object>]
    [-ForegroundColor <ConsoleColor>]
    [-BackgroundColor <ConsoleColor>]
    [<CommonParameters>]

Description

Cmdleten Write-Host anpassar utdata. Du kan ange textfärgen med hjälp av parametern ForegroundColor och du kan ange bakgrundsfärgen med hjälp av parametern BackgroundColor. Med parametern Avgränsare kan du ange en sträng som ska användas för att separera visade objekt. Det specifika resultatet beror på vilket program som är värd för PowerShell.

Anmärkning

Från och med Windows PowerShell 5.0 är Write-Host en omslutning för Write-Information Detta gör att du kan använda Write-Host för att generera utdata till informationsströmmen. På så sätt kan samla in eller undertryckning av data som skrivits med Write-Host samtidigt som bakåtkompatibiliteten bevaras.

Den $InformationPreference inställningsvariabeln och InformationAction vanliga parametern påverkar inte Write-Host meddelanden. Undantaget till den här regeln är -InformationAction Ignore, vilket effektivt undertrycker Write-Host utdata. (se "Exempel 5")

Exempel

Exempel 1: Skriv till konsolen utan att lägga till en ny rad

Write-Host "no newline test " -NoNewline
Write-Host "second string"

no newline test second string

Det här kommandot visar strängen "no newline test" med parametern NoNewline.

En andra sträng skrivs, men den hamnar på samma rad som den första på grund av att det inte finns någon ny rad som avgränsar strängarna.

Exempel 2: Skriv till konsolen och inkludera en avgränsare

Write-Host (2,4,6,8,10,12) -Separator ", +2= "

2, +2= 4, +2= 6, +2= 8, +2= 10, +2= 12

Det här kommandot visar jämna tal från två till tolv. Parametern Avgränsare används för att lägga till strängen , +2= (comma, space, +, 2, =, space).

Exempel 3: Skriva med olika text- och bakgrundsfärger

Write-Host (2,4,6,8,10,12) -Separator ", -> " -ForegroundColor DarkGreen -BackgroundColor White

2, -> 4, -> 6, -> 8, -> 10, -> 12

Det här kommandot visar jämna tal från två till tolv. Den använder parametern ForegroundColor för att mata ut "mörkgrön" text och parametern BackgroundColor för att visa en "vit" bakgrund.

Exempel 4: Skriv med olika text- och bakgrundsfärger

Write-Host "Red on white text." -ForegroundColor red -BackgroundColor white

Red on white text.

Det här kommandot visar strängen "Röd på vit text". Texten är "röd", enligt definitionen i parametern ForegroundColor. Bakgrunden är "vit", enligt definitionen i parametern BackgroundColor.

Exempel 5: Utelämna utdata från Write-Host

# The following two statements can be used to effectively suppress output from Write-Host
Write-Host "I won't print" -InformationAction Ignore
Write-Host "I won't print" 6>$null

Det här kommandot visar strängen "Röd på vit text". Texten är "röd", enligt definitionen i parametern ForegroundColor. Bakgrunden är "vit", enligt definitionen i parametern BackgroundColor.

Parametrar

-BackgroundColor

Anger bakgrundsfärgen. Det finns inget standardvärde. De godtagbara värdena för den här parametern är:

  • Svart
  • Mörkblå
  • Mörkgrön
  • MörkCyan
  • Mörkröd
  • MörkMagenta
  • Mörkgul
  • Grått
  • Mörkgrå
  • Blått
  • Grönt
  • Turkosblå
  • Röd
  • Magenta
  • Gul
  • Vit

Parameteregenskaper

Typ:ConsoleColor
Standardvärde:None
Godkända värden:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ForegroundColor

Anger textfärgen. Det finns inget standardvärde. De godtagbara värdena för den här parametern är:

  • Svart
  • Mörkblå
  • Mörkgrön
  • MörkCyan
  • Mörkröd
  • MörkMagenta
  • Mörkgul
  • Grått
  • Mörkgrå
  • Blått
  • Grönt
  • Turkosblå
  • Röd
  • Magenta
  • Gul
  • Vit

Parameteregenskaper

Typ:ConsoleColor
Standardvärde:None
Godkända värden:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NoNewline

Strängrepresentationerna av indataobjekten sammanfogas för att bilda utdata. Inga blanksteg eller nya radrutor infogas mellan utdatasträngarna. Ingen ny rad läggs till efter den senaste utdatasträngen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Object

Objekt som ska visas i värden.

Parameteregenskaper

Typ:Object
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Separator

Anger en avgränsarsträng som ska infogas mellan objekt som visas av värden.

Parameteregenskaper

Typ:Object
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

Object

Du kan skicka pipe-objekt som ska skrivas till värden.

Utdata

None

Write-Host skickar objekten till värden. Det returnerar inga objekt. Värden kan dock visa de objekt som Write-Host skickar till den.