egyéni kimenetet ír egy gazdagépre.
szintaxis
leírás
The Write-Host
cmdlet ” s elsődleges célja, hogy készítsen a-(host)-display-only kimenet, mint asprinting színes szöveget, mint amikor kéri a felhasználó input együtt Read-Host.Write-Host
a ToString() metódust használja az output írásához., Ezzel szemben, a kimeneti adatok a csővezeték, használja Write-Output vagy implicitoutput.
megadhatja a szöveg színét a ForegroundColor
paraméter segítségével, és megadhatjaa háttér színét a BackgroundColor
paraméter segítségével. Az elválasztó paraméter lehetővé teszi a megadástegy karakterlánc a megjelenített objektumok elválasztásához. Az adott eredmény attól függ, hogy a programhosting PowerShell.
Megjegyzés
kezdve a Windows PowerShell 5.,0, Write-Host
egy wrapper Write-Information
ez lehetővé tesziön használni Write-Host
kibocsátani kimenetet az információáram. Ez lehetővé teszi a Write-Host
használatával írt adatok rögzítését, miközben megőrzi a visszafelé kompatibilitást.
The $InformationPreference
preference variable and InformationAction
common parameter do notaffect Write-Host
messages. A szabály alóli kivétel a -InformationAction Ignore
, amely hatékonyan elnyomja a Write-Host
kimenetet., (lásd az “5.példa”)
példák
1. példa: írjon a konzolba új sor hozzáadása nélkül
Ez a parancs a “Nincs újvonal teszt” karakterláncot jeleníti meg a NoNewline
paraméterrel.
egy második karakterlánc van írva, de a húrok elválasztásának hiánya miatt ugyanazon a vonalon végződik, mint az első.,
2. Példa: Írás, hogy a konzolt tartalmaz elválasztó
3. Példa: Írás a különböző szöveges háttér színek
Ez a parancs megjeleníti a páros számok a két keresztül tizenkettő. AForegroundColor
paramétert használja a sötétzöld szöveg megjelenítéséhez, aBackgroundColor
paramétert pedig a whitebackground megjelenítéséhez.
4. példa: írjon különböző szöveg-és háttérszínekkel
Ez a parancs a “piros fehér szövegen” karakterláncot jeleníti meg.,”A szöveg piros, aForegroundColor
paraméter határozza meg. A háttér fehér, a BackgroundColor
paraméter határozza meg.
5. példa: a
parancsok hatékonyan elnyomják a Write-Host
cmdlet kimenetét. Az első aInformationAction
paramétert használja a Ignore
értékkel, hogy elnyomja az információfolyam kimenetét.,A második példa átirányítja a parancs információfolyamát a $null
változóra éshereby elnyomja azt.
paraméterek
meghatározza a háttér színét. Nincs alapértelmezett.,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., Nincs alapértelmezett.,
The string representations of the input objects are concatenated to form the output., A kimeneti karakterláncok között nincs szóköz vagywlines. Az utolsó kimeneti karakterlánc után nem kerül hozzáadásra újsor.
Típus: | SwitchParameter |
Beosztása: | Nevű |
Alapértelmezett érték: | Nem |
Elfogadni vezeték bemenet: | False |
Elfogadja a helyettesítő karaktereket: | False |
Objektumok megjelenítéséhez a fogadó.,
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., Azonban a hostdisplays az objektumokat, hogy Write-Host
küld rá.
Notes
-
amikor gyűjteményt írunk a gazdagépnek, a gyűjtemény elemeit ugyanazon a vonalon nyomtatjuk ki, egyetlen szóközzel elválasztva. Ez felülbírálható az elválasztó paraméterrel.
-
a nem primitív adattípusok, például a tulajdonságokkal rendelkező objektumok váratlan eredményeket okozhatnak, és nem jelentékeny kimenetet biztosítanak. Például a
Write-Host @{a = 1; b = 2}
kinyomtatja aSystem.Collections.DictionaryEntry System.Collections.DictionaryEntry
fájlt a gazdagépre.,
- Clear-Host
- Out-Host
- Write-Debug
- Write-Error
- Write-Output
- Write-Progress
- Write-Verbose
- Write-Warning