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.