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ő. AForegroundColorparamé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 BackgroundColorparamé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.DictionaryEntryfájlt a gazdagépre.,
- Clear-Host
- Out-Host
- Write-Debug
- Write-Error
- Write-Output
- Write-Progress
- Write-Verbose
- Write-Warning