scrie de ieșire personalizate la o gazdă.
Sintaxa
Descriere
Write-Host cmdlet”e scop principal este de a produce pentru-(host)-display-numai de ieșire, cum ar asprinting text colorat ca atunci când determinat de utilizator pentru intrare în colaborare cu Citit-Gazdă.Write-Host utilizează metoda ToString() pentru a scrieoutput., În schimb, pentru a transmite datele către conductă, utilizați ieșirea de scriere sau implicit.
puteți specifica culoarea textului cu ajutorul ForegroundColor parametru, și puteți specifica thebackground de culoare cu ajutorul BackgroundColor parametru. Parametrul Separator vă permite să specificațiun șir de utilizat pentru a separa obiectele afișate. Rezultatul particular depinde de programul care estehosting PowerShell.
notă
începând cu Windows PowerShell 5.,0, Write-Host este un înveliș pentru Write-Information Acest allowsyou să utilizați Write-Host să emită ieșire la flux de informații. Aceasta permite captarea sau suprimarea datelor scrise folosind Write-Host păstrând compatibilitatea înapoi.
$InformationPreference preferințe variabilă și InformationAction parametru comun face notaffect Write-Host mesaje. Excepție de la această regulă este -InformationAction Ignore, whicheffectively suprimă Write-Host ieșire., (a se vedea „Exemplul 5”)
Exemple
Exemplu 1: Scrie la consola fără a adăuga o nouă linie
Această comandă afișează șirul „nu newline test” cu NoNewline parametru.un al doilea șir este scris, dar se termină pe aceeași linie ca prima din cauza absenței unei linii care separă șirurile.,
Exemplul 2: Scrie la consola și include un separator
Exemplul 3: Scrie cu alt text și culorile de fundal
Această comandă afișează numerele de la doi la doisprezece. Se folosește ForegroundColorparametru de ieșire de culoare verde închis text și BackgroundColor parametru pentru a afișa o whitebackground.
Exemplul 4: Scrieți cu diferite culori de text și fundal
această comandă afișează șirul „roșu pe text alb.,”Textul este roșu, așa cum este definit de parametrulForegroundColor. Fundalul este alb, așa cum este definit de parametrul BackgroundColor.
Exemplul 5: Suprima producția de Write-Host
Aceste comenzi suprima în mod eficient producția de Write-Host cmdlet. Primul utilizează parametrulInformationActioncu valoarea Ignore pentru a suprima ieșirea în fluxul de informații.,Al doilea exemplu redirecționează fluxul de informații al comenzii către variabila $null șiprin urmare, o suprimă.
parametrii
specifică culoarea de fundal. Nu există nici o implicit.,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., Nu există nici o implicit.,
The string representations of the input objects are concatenated to form the output., Nu există spații saunewlines sunt introduse între șirurile de ieșire. Nu se adaugă nicio linie nouă după ultimul șir de ieșire.
| Tip: | SwitchParameter |
| Poziție: | Nume |
| valoare Implicită: | Nimic |
| Accepta conducta de intrare: | False |
| Acceptă metacaractere: | False |
Obiecte pentru a afișa în gazdă.,
| 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., Cu toate acestea, gazda afișează obiectele pe care Write-Host le trimite.
Note
-
când scrieți o colecție gazdei, elementele colecției sunt tipărite pe aceeași linieseparate de un singur spațiu. Acest lucru poate fi anulat cu parametrul Separator.tipurile de date non-primitive, cum ar fi obiectele cu proprietăți, pot provoca rezultate neașteptate și nu oferă rezultate semnificative. De exemplu,
Write-Host @{a = 1; b = 2}va imprimaSystem.Collections.DictionaryEntry System.Collections.DictionaryEntryla gazdă.,