Skriver tilpassede utgang til en vert.
Syntaks
Beskrivelse
Write-Host cmdlet»s primære formål er å produsere for-(host)-skjerm-bare-utgang, slik asprinting farget tekst som når du spørre brukeren for innspill i forbindelse med Lese-Vert.Write-Host bruker den ToString() metode for å skrive theoutput., I kontrast til dette, for å sende data til rørledningen, bruk Skrive Ut eller implicitoutput.
Du kan angi fargen på teksten ved å bruke ForegroundColor parameter, og du kan angi thebackground farge ved hjelp av BackgroundColor – parameteren. Separatoren parameteren kan du specifya string å bruke for å skille vises objekter. Det bestemt resultat avhenger av programmet som ishosting PowerShell.
Merk
Start i Windows PowerShell-5.,0, Write-Host er en wrapper for Write-Information Dette allowsyou å bruke Write-Host avgis utgang til informasjon stream. Dette gjør det mulig å fange orsuppression av data som skrives ved hjelp av Write-Host samtidig opprettholde bakoverkompatibilitet.
$InformationPreference preferanser variabel og InformationAction vanlige parameteren gjør notaffect Write-Host meldinger. Unntaket fra denne regelen er -InformationAction Ignore, whicheffectively undertrykker Write-Host utdata., (se Eksempel 5″)
Eksempler på
Eksempel 1: Skriv til konsollen uten å legge til en ny linje
Denne kommandoen viser string «ingen newline test» med NoNewline – parameteren.
En annen streng som er skrevet, men det ender opp på samme linje som den første på grunn av fravær av anewline skille strenger.,
Eksempel 2: Skriv til konsollen og inkluderer en separator
Eksempel 3: Skrive med ulike tekst-og bakgrunnsfarger
Denne kommandoen viser også tall fra to til tolv. Den bruker ForegroundColor – parameteren til utgang mørk grønn tekst og BackgroundColor parameter for å vise en whitebackground.
Eksempel 4: Skrive med ulike tekst-og bakgrunnsfarger
Denne kommandoen viser string «Rød på hvit tekst.,»Teksten er rød, som definert avForegroundColor – parameteren. Bakgrunnen er hvit, som definert av BackgroundColor – parameteren.
Eksempel 5: Undertrykke utgang fra Write-Host
Disse kommandoene effektivt undertrykke produksjonen av Write-Host cmdleten. Det første man brukerInformationAction parameter med Ignore Verdi for å undertrykke utgang til informasjon stream.,Det andre eksemplet omdirigerer informasjon strøm av kommandoen $null variabel andthereby undertrykker det.
Parametere
Angir bakgrunnsfargen. Det er ingen standard.,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., Det er ingen standard.,
The string representations of the input objects are concatenated to form the output., Ingen mellomrom ornewlines er satt inn mellom utgang strenger. Ingen newline er lagt til etter den siste utgang strengen.
| Skriv: | SwitchParameter |
| Posisjon: | Navnet |
| Standard verdi: | Ingen |
| Godta rørledning innspill: | False |
| Godta jokertegn: | False |
Objekter som skal vises i host.,
| 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., Men hostdisplays objekter som Write-Host sender til det.
Notater
-
Når du skriver en samling til verten, elementer i samlingen er trykt på samme lineseparated med et enkelt mellomrom. Dette kan overstyres med Skilletegn for parameteren.
-
Ikke-primitive datatyper som objekter med egenskaper som kan føre til uventede resultater og notprovide meningsfull produksjon. For eksempel,
Write-Host @{a = 1; b = 2}vil skrive utSystem.Collections.DictionaryEntry System.Collections.DictionaryEntrytil verten.,
- Fjern-Vert
- Ut-Vert
- Skrive-Debug
- Skrive-Feil
- Skriv Ut
- Skrive-Progress
- Skrive-Verbose
- Skrive-Advarsel