Sdílet prostřednictvím

Write-Host

Modul:
Microsoft.PowerShell.Utility Module

Zapisuje přizpůsobený výstup do hostitele.

Syntax

Default (Výchozí) 

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

Description

Rutina Write-Host přizpůsobí výstup. Barvu textu můžete zadat pomocí parametru ForegroundColor a barvu pozadí můžete zadat pomocí parametru BackgroundColor. Parametr Oddělovač umožňuje zadat řetězec, který se má použít k oddělení zobrazených objektů. Konkrétní výsledek závisí na programu, který hostuje PowerShell.

Poznámka:

Počínaje Windows PowerShellem 5.0 je Write-Host obálka pro Write-Information. To umožňuje použít Write-Host k vygenerování výstupu do informačního datového proudu. To umožňuje zachycení nebo potlačení dat zapsaných pomocí Write-Host a zachování zpětné kompatibility.

Proměnná předvoleb $InformationPreference a InformationAction společný parametr neovlivňují Write-Host zprávy. Výjimkou tohoto pravidla je -InformationAction Ignore, který efektivně potlačuje Write-Host výstup. (viz "Příklad 5")

Příklady

Příklad 1: Zápis do konzoly bez přidání nového řádku

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

no newline test second string

Tento příkaz zobrazí řetězec no newline test s parametrem NoNewline.

Druhý řetězec se zapíše, ale skončí na stejném řádku jako první kvůli absenci nového řádku oddělující řetězce.

Příklad 2: Zápis do konzoly a zahrnutí oddělovače

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

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

Tento příkaz zobrazí sudá čísla ze dvou až dvanácti. Parametr Oddělovač se používá k přidání řetězce , +2= (comma, space, +, 2, =, space).

Příklad 3: Psaní s různými barvami textu a pozadí

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

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

Tento příkaz zobrazí sudá čísla ze dvou až dvanácti. Používá ForegroundColor parametr k výstupu "tmavě zeleného" textu a parametr BackgroundColor k zobrazení "bílé" pozadí.

Příklad 4: Psaní s různými barvami textu a pozadí

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

Red on white text.

Tento příkaz zobrazí řetězec "Červený na bílém textu". Text je červený, jak je definován parametrem ForegroundColor. Pozadí je "bílé", jak je definováno parametrem BackgroundColor.

Příklad 5: Potlačení výstupu z 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

Tento příkaz zobrazí řetězec "Červený na bílém textu". Text je červený, jak je definován parametrem ForegroundColor. Pozadí je "bílé", jak je definováno parametrem BackgroundColor.

Parametry

-BackgroundColor

Určuje barvu pozadí. Neexistuje výchozí nastavení. Přijatelné hodnoty pro tento parametr jsou:

  • Černý
  • Tmavě modrá
  • Tmavá zelená
  • DarkCyan
  • Tmavě červená
  • Tmavá purpurová
  • Tmavě žlutá
  • Šedý
  • Tmavě šedá
  • Modrý
  • Zelený
  • Cyan
  • Červený
  • Fialový
  • Žlutá
  • Bílý

Vlastnosti parametru

Typ:ConsoleColor
Default value:None
Přípustné hodnoty:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ForegroundColor

Určuje barvu textu. Neexistuje výchozí nastavení. Přijatelné hodnoty pro tento parametr jsou:

  • Černý
  • Tmavě modrá
  • Tmavá zelená
  • DarkCyan
  • Tmavě červená
  • Tmavá purpurová
  • Tmavě žlutá
  • Šedý
  • Tmavě šedá
  • Modrý
  • Zelený
  • Cyan
  • Červený
  • Fialový
  • Žlutá
  • Bílý

Vlastnosti parametru

Typ:ConsoleColor
Default value:None
Přípustné hodnoty:Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NoNewline

Řetězcové reprezentace vstupních objektů jsou zřetězeny tak, aby vytvořily výstup. Mezi výstupní řetězce se nevkládají žádné mezery ani nové čáry. Za poslední výstupní řetězec se nepřidá žádný nový řádek.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Object

Objekty, které se mají zobrazit v hostiteli

Vlastnosti parametru

Typ:Object
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Separator

Určuje řetězec oddělovače, který se má vložit mezi objekty zobrazené hostitelem.

Vlastnosti parametru

Typ:Object
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Object

Objekty můžete zapsat do hostitele.

Výstupy

None

Write-Host odešle objekty hostiteli. Nevrací žádné objekty. Hostitel ale může zobrazit objekty, které Write-Host do něj odesílá.