Out-Host
Sendet die Ausgabe an die Befehlszeile.
Syntax
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Out-Host sendet die Ausgabe zur Anzeige an den PowerShell-Host. Der Host zeigt die Ausgabe an der Befehlszeile an. Da Out-Host die Standardeinstellung ist, müssen Sie sie nur angeben, wenn Sie dessen Parameter verwenden möchten.
Out-Host übergibt die Ausgabe der Pipeline an den Host, der den Befehl ausführt.
Out-Host ignoriert ANSI-Escapesequenzen. Die Escapesequenzen werden vom Host behandelt.
Out-Host übergeben ANSI-Escapesequenzen an den Host, ohne sie zu interpretieren oder zu ändern.
Beispiele
Beispiel 1: Gleichzeitiges Anzeigen der Ausgabe einer Seite
In diesem Beispiel wird das System jeweils eine Seite verarbeitet.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process ruft das System ab und sendet die Objekte an die Pipeline.
Out-Host verwendet den parameter Paging, um jeweils eine Seite mit Daten anzuzeigen.
Beispiel 2: Verwenden einer Variablen als Eingabe
In diesem Beispiel werden Objekte verwendet, die in einer Variablen als Eingabe für Out-Hostgespeichert sind.
$io = Get-History
Out-Host -InputObject $io
Get-History ruft den Verlauf der PowerShell-Sitzung ab und speichert die Objekte in der $io Variablen.
Out-Host verwendet den parameter InputObject, um die variable $io anzugeben und den Verlauf anzuzeigen.
Parameter
-InputObject
Gibt die Objekte an, die in die Konsole geschrieben werden. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte ermittelt.
Parametereigenschaften
| Typ: | PSObject |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Paging
Gibt an, dass Out-Host jeweils eine Seite der Ausgabe angezeigt wird. Die Seitengröße wird durch die Merkmale des Hosts bestimmt.
Nach der Ausgabe der ersten Seite wartet der Befehl auf die Benutzereingabe, bevor die verbleibenden Seiten angezeigt werden. Drücken Sie die LEERTASTE , um die nächste Ausgabeseite oder die EINGABETASTE anzuzeigen, um die nächste Ausgabezeile anzuzeigen. Drücken Sie Q-, um den Befehl zu beenden.
Die Verwendung von Paging ähnelt der Verwendung des Befehls "Mehr ".
Hinweis
Der parameter Paging wird vom PowerShell ISE-Host nicht unterstützt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
PSObject
Sie können jedes Objekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück. Es sendet Objekte zur Anzeige an den Host.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Out-Host:
oh
Nicht alle PowerShell-Hosts unterstützen den Paging-Parameter . Wenn Sie beispielsweise den Paging-Parameter in windows PowerShell ISE verwenden, wird der folgende Fehler angezeigt:
out-lineoutput: Die Methode oder der Vorgang ist nicht implementiert.
Die Cmdlets, die das verb Out enthalten, Out-, formatieren keine Objekte. Sie rendern Objekte und senden sie an das angegebene Anzeigeziel. Wenn Sie ein unformatiertes Objekt an ein Out--Cmdlet senden, sendet das Cmdlet es an ein Formatierungs-Cmdlet, bevor es gerendert wird.
Die Out- Cmdlets lesen keine Eingaben aus Dateien. Zum Senden von Daten an ein Out- Cmdlet verwenden Sie die Pipeline, um Daten an das Cmdlet zu senden. Alternativ können Sie Daten in einer Variablen speichern und den parameter InputObject verwenden, um die Daten an das Cmdlet zu übergeben.
Out-Host sendet nur Daten an den Host. Tt erzeugt keine Ausgabeobjekte für die Pipeline. Wenn Sie die Ausgabe von Out-Host an das cmdlet Get-Member weiterleiten, Get-Member Meldet, dass keine Objekte angegeben wurden.
