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 ForegroundColor
parametru 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ă parametrulInformationAction
cu 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.DictionaryEntry
la gazdă.,