skriver tilpasset output til en vært.
Syntaks
Beskrivelse
Write-Host cmdlet”s primære formål er at producere til-(host)-display-kun produktionen, sådan asprinting farvet tekst som når at spørge brugeren for input i forbindelse med Læse-Vært.Write-Host bruger toString () – metoden til at skrive theoutput., I modsætning hertil, at output data til rørledningen, bruge skrive-Output eller implicitoutput.
Du kan angive farven på teksten ved at bruge parameteren ForegroundColor, og du kan specificerebaggrundsfarve ved at bruge parameteren BackgroundColor. Separatorparameteren giver dig mulighed for at angiveen streng, der skal bruges til at adskille viste objekter. Det særlige resultat afhænger af det program, der erhosting Po .ershell.
Bemærk
starter i Powerindo .s Po .ershell 5.,0, Write-Host er en wrapper for Write-Information Denne allowsyou at bruge Write-Host til at udsende output til de oplysninger, stream. Dette muliggør optagelse eller understøttelse af data skrevet ved hjælp af Write-Host, mens bagudkompatibilitet bevares.
$InformationPreference præferencer variabel og InformationAction fælles parameter gøre notaffect Write-Host beskeder. Undtagelsen fra denne regel er -InformationAction Ignore, someffektivt undertrykker Write-Host output., (se “Eksempel 5”)
Eksempler
Eksempel 1: Skrive til konsollen uden at tilføje en ny linje
Denne kommando viser string “no newline test” med NoNewline parameter.
en anden streng er skrevet, men den ender på samme linje som den første på grund af fraværet af en ny linje, der adskiller strengene.,
Eksempel 2: Skrive til konsollen og omfatter en separator
Eksempel 3: Skriv med forskellige tekst-og baggrunds farver
Denne kommando viser de lige tal fra to til tolv. Den bruger parameteren ForegroundColortil at udsende mørkegrøn tekst og parameteren BackgroundColor til at vise en whithitebackground.
eksempel 4: Skriv med forskellige tekst-og baggrundsfarver
denne kommando viser strengen “rød på hvid tekst.,”Teksten er rød, som defineret af parameterenForegroundColor. Baggrunden er hvid, som defineret af parameteren BackgroundColor.
Eksempel 5: Undertrykker output fra Skrive-Vært
Disse kommandoer effektivt at undertrykke produktionen af Write-Host cmdlet. Den første bruger parameterenInformationAction med Ignore for at undertrykke output til informationsstrømmen.,Det andet eksempel omdirigerer informationsstrømmen af kommandoen til $null variabel ogderved undertrykker den.
Parametre
Angiver baggrundsfarven. Der 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., Der er ingen standard.,
The string representations of the input objects are concatenated to form the output., Ingen mellemrum ellernylinjer indsættes mellem udgangsstrengene. Ingen ne .line tilføjes efter den sidste output streng.
| Type: | SwitchParameter |
| Position: | ved navn |
| Standard værdi: | Ingen |
| Accepter pipeline input: | False |
| bruges sammen med jokertegn: | False |
Objekter, der skal vises i værtslandet.,
| 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., Værtenviser dog de objekter, som Write-Host sender til den.
noter
-
Når du skriver en samling til værten, udskrives elementer af samlingen på samme linjeadskilt af et enkelt mellemrum. Dette kan tilsidesættes med Separatorparameteren.
-
ikke-primitive datatyper såsom objekter med egenskaber kan forårsage uventede resultater og ikkegive meningsfuld output. For eksempel vil
Write-Host @{a = 1; b = 2}udskriveSystem.Collections.DictionaryEntry System.Collections.DictionaryEntrytil værten.,
- Ryd-Vært
- Ud-Vært
- Skriv-Debug
- Skriv-Fejl
- Skriv-Output
- Skriv-Fremskridt
- Skriv-Verbose
- Skriv-Advarsel