zapisuje přizpůsobený výstup hostiteli.
Syntax
Popis
Write-Host
cmdlet“s primárním účelem je vyrábět pro-(hostitel)-displej-pouze výstup, jako astisk barevný text, jako když se uživateli zobrazil výzvu pro vstup ve spojení s Read-Hostitel.Write-Host
používá metodu ToString() pro zápis theoutput., Naproti tomu pro výstup dat do potrubí použijte Write-Output nebo implicitoutput.
barvu textu můžete zadat pomocí parametru ForegroundColor
a můžete zadat barvu pozadí pomocí parametru BackgroundColor
. Parametr separátoru umožňuje specifikovat řetězec, který se používá k oddělení zobrazených objektů. Konkrétní výsledek závisí na programu, který jevosting PowerShell.
Poznámka
spuštění v systému Windows PowerShell 5.,0, Write-Host
je wrapper pro Write-Information
allowsyou použít Write-Host
vyzařovat výstup na informační tok. To umožňuje zachytit orsuppression dat zapsaných pomocí Write-Host
při zachování zpětné kompatibility.
$InformationPreference
preference proměnná a InformationAction
společný parametr dělat notaffect Write-Host
zprávy. Výjimkou z tohoto pravidla je-InformationAction Ignore
, který účinně potlačujeWrite-Host
výstup., (viz „Příklad 5“)
Příklady
Příklad 1: Napište do konzoly bez přidání nového řádku
Tento příkaz zobrazí řetězec „ne newline test“ s NoNewline
parametr.
je napsán druhý řetězec, ale končí na stejném řádku jako první kvůli absenci nové čáry oddělující řetězce.,
Příklad 2: Napište do konzole a obsahovat oddělovač
Příklad 3: Napište, s různými barvy textu a pozadí
Tento příkaz zobrazuje i čísla od dvou do dvanácti. Používá parametr ForegroundColor
pro výstup tmavě zeleného textu a parametr BackgroundColor
pro zobrazení whitebackground.
Příklad 4: Napište, s různými barvy textu a pozadí
Tento příkaz zobrazí řetězec „Červená na bílém textu.,“Text je červený, jak je definováno parametremForegroundColor
. Pozadí je bílé, jak je definováno parametremBackgroundColor
.
Příklad 5: Potlačit výstup z Write-Host
Tyto příkazy efektivně potlačit výstup Write-Host
rutiny. První používá parametrInformationAction
s hodnotouIgnore
k potlačení výstupu do informačního proudu.,Druhý příklad přesměruje informační proud příkazu na proměnnou $null
a potlačí ji.
parametry
určuje barvu pozadí. Neexistuje žádné výchozí.,ellow
Type: | ConsoleColor |
Accepted values: | Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the text color., Neexistuje žádné výchozí.,
The string representations of the input objects are concatenated to form the output., Mezi výstupní řetězce nejsou vkládány žádné mezery ani nové řádky. Po posledním výstupním řetězci není přidán žádný nový řádek.
Typ: | SwitchParameter |
Poloha: | Jménem |
Výchozí hodnota: | None |
Přijmout potrubí vstup: | False |
použít zástupné znaky: | False |
Objekty pro zobrazení v hostiteli.,
Type: | Object |
Aliases: | Msg, Message |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Specifies a separator string to insert between objects displayed by the host.,
Type: | Object |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Object
You can pipe objects to be written to the host.
Outputs
None
Write-Host
sends the objects to the host. It does not return any objects., Hostdisplays objekty, které Write-Host
odešle do něj.
Poznámky
-
Při psaní sbírky host, prvky kolekce jsou vytištěny na stejné lineseparated do jednoho prostoru. To může být přepsáno parametrem separátoru.
-
primitivní datové typy, jako jsou objekty s vlastnostmi, mohou způsobit neočekávané výsledky a neposkytovat smysluplný výstup. Například
Write-Host @{a = 1; b = 2}
vytiskneSystem.Collections.DictionaryEntry System.Collections.DictionaryEntry
hostiteli.,
- Jasné-Host
- Host
- Napsat-Debug
- Zápis-Chyba
- Write-Output
- Napsat-Pokrok
- Write-Verbose
- Napsat-Varování