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 ForegroundColorpro 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.DictionaryEntryhostiteli.,
- Jasné-Host
- Host
- Napsat-Debug
- Zápis-Chyba
- Write-Output
- Napsat-Pokrok
- Write-Verbose
- Napsat-Varování