skriver Anpassad utdata till en värd.
Syntax
beskrivning
Write-Host
cmdlet”s primära syfte är att producera för-(värd)-display-only output, t.ex. printing färgad text som när du uppmanas användaren för inmatning i samband med Read-Host.Write-Host
använder ToString () – metoden för att skriva resultatet., Däremot, för att mata ut data till rörledningen, använd skriv-Output eller implicitoutput.
Du kan ange textfärgen med hjälp av parametern ForegroundColor
, och du kan angebakgrundsfärgen med hjälp av parametern BackgroundColor
. Parametern Separator låter dig angeen sträng att använda för att separera visade objekt. Det särskilda resultatet beror på det program som ärvandrande PowerShell.
Obs
startar i Windows PowerShell 5.,0, Write-Host
är ett omslag för Write-Information
detta tillåterdu använder Write-Host
för att avge utdata till informationsflödet. Detta gör det möjligt att fånga orsuppression av data skrivna med Write-Host
samtidigt som bakåtkompatibilitet bevaras.
$InformationPreference
inställningsvariabel ochInformationAction
gemensam parameter påverkar inteWrite-Host
meddelanden. Undantaget från denna regel är-InformationAction Ignore
, whicheffectively undertryckerWrite-Host
– utmatning., exempel 1: Skriv till konsolen utan att lägga till en ny rad
det här kommandot visar strängen ”no newline test” med parametern NoNewline
.
en andra sträng skrivs, men den hamnar på samma linje som den första på grund av frånvaron av en ny linje som skiljer strängarna.,
exempel 2: Skriv till konsolen och inkludera en separator
exempel 3: Skriv med olika text-och bakgrundsfärger
det här kommandot visar de jämna siffrorna från två till tolv. Den använder parameternForegroundColor
för att mata ut mörkgrön text och parameternBackgroundColor
för att visa en vit bakgrund.
exempel 4: Skriv med olika text-och bakgrundsfärger
det här kommandot visar strängen ”röd på vit text.,”Texten är röd, enligt definitionen i parameternForegroundColor
. Bakgrunden är vit, enligt definitionen i parametern BackgroundColor
.
exempel 5: undertrycka utdata från Skrivvärd
dessa kommandon undertrycker effektivt utdata frånWrite-Host
cmdlet. Den första använder parameternInformationAction
med värdet Ignore
för att undertrycka utmatningen till informationsflödet.,Det andra exemplet omdirigerar informationsflödet för kommandot till variabeln$null
ochthereby undertrycker den.
parametrar
anger bakgrundsfärgen. Det finns 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 finns ingen standard.,
The string representations of the input objects are concatenated to form the output., Inga mellanslag ornewlines infogas mellan utdatasträngarna. Ingen newline läggs till efter den senaste utdatasträngen.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | ingen |
Acceptera pipeline ingång: | False |
Acceptera jokertecken: | falskt |
objekt som ska visas i värden.,
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., Hostdisplays dock objekten som Write-Host
skickar till den.
anteckningar
-
När du skriver en samling till värden skrivs element i samlingen ut på samma radseparerad av ett enda utrymme. Detta kan åsidosättas med Separatorparametern.
-
icke-primitiva datatyper som objekt med egenskaper kan orsaka oväntade resultat och intege meningsfull utgång. Till exempel kommer
Write-Host @{a = 1; b = 2}
att skriva utSystem.Collections.DictionaryEntry System.Collections.DictionaryEntry
till värden.,
- Clear-Host
- Out-Host
- Write-Debug
- Write-Error
- Write-Output
- Write-Progress
- Write-Verbose
- Write-Warning