Schreibt eine benutzerdefinierte Ausgabe in einen Host. (Write-Host)
NAMEWrite-HostÜBERSICHTSchreibt eine benutzerdefinierte Ausgabe in einen Host.SYNTAXWrite-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>]BESCHREIBUNGMit 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".EINGABENSystem.Object Sie können Objekte, die in den Host geschrieben werden sollen, über die Pipeline übergeben.AUSGABENKeiner 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.HINWEISEBeispiele
BEISPIEL 1C:\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 2C:\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 3C:\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 4C:\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
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export