schrijft aangepaste uitvoer naar een host.
syntaxis
Description
het primaire doel van Write-Host cmdlet is om voor-(host)-display-only uitvoer te produceren, zoals gekleurde tekst afdrukken zoals wanneer de gebruiker wordt gevraagd om invoer in combinatie met Read-Host.Write-Host gebruikt de ToString() methode om de uitvoer te schrijven., In tegenstelling, om de uitvoer van gegevens naar de pijplijn, gebruik Write-Output of implicitoutput.
u kunt de kleur van tekst opgeven met behulp van deForegroundColor parameter, en u kunt de achtergrondkleur opgeven met behulp van deBackgroundColor parameter. De scheidingsteken parameter kunt u specifyeen string te gebruiken om weergegeven objecten te scheiden. Het specifieke resultaat hangt af van het programma dat Ishosting PowerShell.
opmerking
start in Windows PowerShell 5.,0, Write-Host is een wrapper voor Write-Information Hiermee kunt u Write-Host gebruiken om uitvoer naar de informatiestroom uit te zenden. Dit maakt het mogelijk om gegevens die zijn geschreven met Write-Host vast te leggen of te ondersteunen met behoud van achterwaartse compatibiliteit.
De $InformationPreference voorkeursvariabele en InformationAction gemeenschappelijke parameter hebben geen invloed op Write-Host berichten. De uitzondering op deze regel is -InformationAction Ignore, wat effectief Write-Host uitvoer onderdrukt., (zie “voorbeeld 5”)
voorbeelden
Voorbeeld 1: Schrijf naar de console zonder een nieuwe regel toe te voegen
Dit commando toont de string “no newline test” met de NoNewline parameter.
een tweede tekenreeks wordt geschreven, maar deze eindigt op dezelfde regel als de eerste door de afwezigheid van een nieuwe regel die de tekenreeksen scheidt.,
Voorbeeld 2: Schrijf naar de console en voeg een scheidingsteken toe
Voorbeeld 3: Schrijf met verschillende tekst-en achtergrondkleuren
Dit commando toont de even getallen van twee tot twaalf. Het gebruikt deForegroundColorparameter om donkergroene tekst uit te voeren en deBackgroundColor parameter om een witte achtergrond weer te geven.
Voorbeeld 4: Schrijf met verschillende tekst-en achtergrondkleuren
Dit commando toont de tekenreeks ” rood op witte tekst.,”De tekst is rood, zoals gedefinieerd door de parameterForegroundColor. De achtergrond is wit, zoals gedefinieerd door de parameter BackgroundColor.
Voorbeeld 5: Output van Write-Host onderdrukken
deze commando ‘ s onderdrukken effectief de uitvoer van de Write-Host cmdlet. De eerste gebruikt de parameterInformationAction met de waarde Ignore om de uitvoer naar de informatiestroom te onderdrukken.,Het tweede voorbeeld leidt de informatiestroom van het commando om naar de $null variabele en onderdrukt deze.
Parameters
geeft de achtergrondkleur aan. Er is geen standaard.,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., Er is geen standaard.,
The string representations of the input objects are concatenated to form the output., Er worden geen spaties of nieuwe regels ingevoegd tussen de uitvoerstrings. Er wordt geen nieuwe regel toegevoegd na de laatste uitvoerstring.
| Type: | SwitchParameter |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | False |
| Accepteren wildcard tekens: | False |
Objecten weergeven in de gastheer.,
| 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., Echter, de hostdisplays de objecten die Write-Host stuurt.
Notes
-
bij het schrijven van een verzameling naar de host worden elementen van de verzameling afgedrukt op dezelfde regel, gescheiden door een enkele spatie. Dit kan worden overschreven met de scheidingsteken parameter.
-
niet-primitieve gegevenstypen zoals objecten met eigenschappen kunnen onverwachte resultaten veroorzaken en geen betekenisvolle uitvoer bieden. Bijvoorbeeld,
Write-Host @{a = 1; b = 2}zalSystem.Collections.DictionaryEntry System.Collections.DictionaryEntrynaar de host afdrukken.,
- Clear-Host
- Out-Host
- Write-Debug
- Write-Error
- Write-Output
- Write-Progress
- Write-Verbose
- Write-Warning