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ää ForegroundColor
parametri 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 BackgroundColor
parametri.
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.DictionaryEntry
isäntä.,
- Selvä-Isäntä
- Pois-Isäntä
- Write-Debug-tietoihin
- Write-Virhe
- Write-Tuotos
- Write-Kehitykseen
- Write-Verbose
- Write-Varoitus