kirjoittaa räätälöityä ulostuloa isännälle.
Syntax
Kuvaus
Write-Host cmdlet-komento”s ensisijainen tarkoitus on tuottaa-(isäntä)-näyttö-vain ulostulo, kuten asprinting värillistä tekstiä, kuten silloin, kun kehotukset käyttäjä syöttää yhdessä Lue-Host.Write-Host käyttää toString () – menetelmää ulostulotehon kirjoittamiseen., Sen sijaan, tuotos tiedot putki, käytä kirjoittaa-Output tai implisiittinenoutput.
Voit määrittää tekstin väriä käyttämällä ForegroundColor parametri, ja voit määrittää thebackground väri käyttämällä BackgroundColor parametri. Erottimen parametrin avulla voit määrittää merkkijonon, jolla erotat näytetyt objektit. Erityinen tulos riippuu ohjelmasta, joka ishosting PowerShell.
Huomautus
alkaen Windows PowerShell 5: stä.,0, Write-Host on kääre Write-Information Tämä allowsyou käyttää Write-Host emit lähtö tietovirta. Tämä mahdollistaa kaapata orsuppression tietoja kirjoitettu käyttäen Write-Host säilyttäen taaksepäin yhteensopivuus.
$InformationPreference etusija muuttuja ja InformationAction yhteinen parametri ei vaikuta siihen, Write-Host viestit. Poikkeuksena tähän sääntöön on -InformationAction Ignore, whicheffectively estää Write-Host lähtö., (katso ”Esimerkki 5”)
Esimerkkejä
Esimerkki 1: Kirjoita konsoliin ilman lisäämällä uusi rivi
Tämä komento näyttää merkkijono ”ei newline-testi”, jossa NoNewline parametri.
toinen merkkijono on kirjoitettu, mutta se päätyy samalla rivillä kuin ensimmäinen, koska ilman anewline erottaa jouset.,
Esimerkki 2: Kirjoita konsoliin ja sisältävät erotin
Esimerkki 3: Kirjoittaa eri tekstin ja taustan värejä
Tämä komento näyttää jopa numeroita kahdesta kahteentoista. Se käyttää ForegroundColorparametri lähtö tumman vihreä teksti ja BackgroundColor parametri näyttää whitebackground.
Esimerkki 4: Kirjoittaa eri tekstin ja taustan värejä
Tämä komento näyttää merkkijono ”Punainen valkoisella tekstillä.,”Teksti on punainen, kuten määriteltyForegroundColor parametri. Tausta on valkoinen, kuten määritelty BackgroundColorparametri.
Esimerkki 5: Tukahduttaa lähtö Kirjoita-Isäntä
Nämä komennot tehokkaasti tukahduttaa lähtö Write-Host cmdlet-komentoa. Ensimmäinen käyttääInformationAction parametri Ignore Arvo tukahduttaa lähtö tietovirta.,Toinen esimerkki ohjaa komennon informaatiovirran $null muuttujaan ja estää sen.
Parametrit
Määrittää taustavärin. Ei ole oletusarvoa.,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., Ei ole oletusarvoa.,
The string representations of the input objects are concatenated to form the output., Lähtöruutujen väliin ei aseteta välilyöntejä ornewlines. Ei newline lisätään jälkeen viimeinen lähtö merkkijono.
| Tyyppi: | SwitchParameter |
| Sijainti: | Nimeltä |
| Oletus arvo: | Ei |
| Hyväksy putki ohjaus: | False |
| Hyväksy yleismerkkejä: | False |
Objektit näyttää vastaanottavan.,
| 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., Kuitenkin hostdisplays esineitä, jotka Write-Host lähettää se.
Huomautuksia
-
Kun kirjoitat kokoelma isäntä, elementit kokoelma on painettu sama lineseparated yhdellä tilaa. Tämä voidaan ohittaa erottimen parametrilla.
-
Ei-alkukantaiset tietotyyppejä, kuten objekteja, joiden ominaisuuksia voi aiheuttaa odottamattomia tuloksia ja notprovide merkityksellinen tuotos. Esimerkiksi
Write-Host @{a = 1; b = 2}tulostaSystem.Collections.DictionaryEntry System.Collections.DictionaryEntryisäntä.,
- Selvä-Isäntä
- Pois-Isäntä
- Write-Debug-tietoihin
- Write-Virhe
- Write-Tuotos
- Write-Kehitykseen
- Write-Verbose
- Write-Varoitus