Schreibt eine benutzerdefinierte Ausgabe in einen Host. (Write-Host)
NAME
Write-Host
# ÜBERSICHT
Schreibt eine benutzerdefinierte Ausgabe in einen Host.
# SYNTAX
Write-Host [[-Object] <Object>] [-BackgroundColor {Black | DarkBlue | DarkGreen | DarkCyan | DarkRed | DarkMagenta | DarkYellow | Gray | DarkGray | Blue | Green | Cyan | Red | Magenta | Yellow | White}] [-ForegroundColor {Black | DarkBlue | DarkGreen | DarkCyan | DarkRed | DarkMagenta | DarkYellow | Gray | DarkGray | Blue | Green | Cyan | Red | Magenta | Yellow | White}] [-NoNewline] [-Separator <Object>] [<CommonParameters>]
# BESCHREIBUNG
Mit dem Cmdlet "Write-Host" wird die Ausgabe angepasst. Mit dem ForegroundColor-Parameter können Sie die Textfarbe angeben, und mit dem BackgroundColor-Parameter können Sie die Hintergrundfarbe angeben. Der Separator-Parameter ermöglicht Ihnen die Angabe einer Zeichenfolge, mit der angezeigte Objekte getrennt werden. Das jeweilige Ergebnis hängt von dem Programm ab, das Windows PowerShell hostet.
# PARAMETER
-BackgroundColor <ConsoleColor>
Gibt die Hintergrundfarbe an. Es gibt keinen Standardwert.
Erforderlich? false
Position? named
Standardwert Keiner
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-ForegroundColor <ConsoleColor>
Gibt die Textfarbe an. Es gibt keinen Standardwert.
Erforderlich? false
Position? named
Standardwert Keiner
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-NoNewline [<SwitchParameter>]
Gibt an, dass der in der Konsole angezeigte Inhalt nicht mit einem Neue-Zeile-Zeichen endet.
Erforderlich? false
Position? named
Standardwert Keiner
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
-Object <Object>
Objekte, die in der Konsole angezeigt werden sollen.
Erforderlich? false
Position? 1
Standardwert Keiner
Pipelineeingaben akzeptieren?true (ByValue)
Platzhalterzeichen akzeptieren?false
-Separator <Object>
Die Zeichenfolge, die zwischen in der Konsole angezeigten Objekten ausgegeben werden soll.
Erforderlich? false
Position? named
Standardwert Keiner
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?false
<CommonParameters>
Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "get-help about_commonparameters".
# EINGABEN
System.Object
Sie können Objekte, die in den Host geschrieben werden sollen, über die Pipeline übergeben.
# AUSGABEN
Keiner
Write-Host sendet die Objekte an den Host. Es werden keine Objekte zurückgegeben. Der Host kann jedoch die Objekte anzeigen, die Write-Host an ihn sendet.
# HINWEISE
# BEISPIEL 1
C:\PS>write-host "no newline test " -nonewline
no newline test C:\PS>
Beschreibung
-----------
Mit diesem Befehl wird die Eingabe in der Konsole angezeigt. Wegen des NoNewline-Parameters folgt die Eingabeaufforderung jedoch direkt auf die Ausgabe.
# BEISPIEL 2
C:\PS>write-host (2,4,6,8,10,12) -Separator ", +2= "
2, +2= 4, +2= 6, +2= 8, +2= 10, +2= 12
Beschreibung
-----------
Mit diesem Befehl werden die geraden Zahlen von 2 bis 12 angezeigt. Der Separator-Parameter wird verwendet, um die Zeichenfolge ", +2= "(Komma, Leerzeichen, +, 2, =, Leerzeichen) hinzuzufügen.
# BEISPIEL 3
C:\PS>write-host (2,4,6,8,10,12) -Separator ", -> " -foregroundcolor DarkGreen -backgroundcolor white
Beschreibung
-----------
Mit diesem Befehl werden die geraden Zahlen von 2 bis 12 angezeigt. Mit dem ForegroundColor-Parameter wird dunkelgrüner Text ausgegeben, und mit dem BackgroundColor-Parameter wird ein weißer Hintergrund angezeigt.
# BEISPIEL 4
C:\PS>write-host "Red on white text." -ForegroundColor red -BackgroundColor white
Red on white text.
Beschreibung
-----------
Mit diesem Befehl wird die Zeichenfolge "Red on white text" angezeigt. Der Text ist rot, wie vom ForegroundColor-Parameter definiert. Der Hintergrund ist weiß, wie vom BackgroundColor-Parameter definiert.
VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113426 (möglicherweise auf Englisch)
Write-Verbose
Write-Error
Write-Progress
Write-Debug
Write-Output
Write-Warning
Out-Host
C:\Windows>powershell get-help Write-Progress -full
ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.