Out-Host
Sendet eine Ausgabe an die Befehlszeile.
Syntax
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]Beschreibung
Das Out-Host Cmdlet sendet die Ausgabe zur Anzeige an den PowerShell-Host. Der Host zeigt die Ausgabe in der Befehlszeile an. Da Out-Host es sich um die Standardeinstellung handelt, müssen Sie sie nur angeben, wenn Sie die zugehörigen Parameter verwenden möchten.
Out-Host wird automatisch an jeden ausgeführten Befehl angefügt. Die Ausgabe der Pipeline wird an den Host übergeben, der den Befehl ausführt. Out-Host ignoriert ANSI-Escapesequenzen. Die Escapesequenzen werden vom Host verarbeitet. Out-Host übergibt ANSI-Escapesequenzen an den Host, ohne sie zu interpretieren oder zu ändern.
Beispiele
Beispiel 1: Ausgabe seiteweise anzeigen
In diesem Beispiel werden die Systemprozesse nacheinander angezeigt.
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 quitGet-Process ruft die Systemprozesse ab und sendet die Objekte in die Pipeline. Out-Host verwendet den Paging-Parameter , um jeweils eine Datenseite anzuzeigen.
Beispiel 2: Verwenden einer Variablen als Eingabe
In diesem Beispiel werden in einer Variablen gespeicherte Objekte als Eingabe für Out-Hostverwendet.
$io = Get-History
Out-Host -InputObject $ioGet-History ruft den Verlauf der PowerShell-Sitzung ab und speichert die Objekte in der $io Variablen.
Out-Host verwendet den InputObject-Parameter , um die $io Variable 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 einen Ausdruck ein, mit dem die Objekte abgerufen werden.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Paging
Gibt an, dass Out-Host jeweils eine Seite der Ausgabe angezeigt wird und auf Benutzereingaben wartet, bevor die restlichen Seiten angezeigt werden. Standardmäßig wird die gesamte Ausgabe auf einer einzelnen Seite angezeigt. Die Seitengröße wird durch die Eigenschaften des Hosts bestimmt.
Drücken Sie die Leertaste , um die nächste Ausgabeseite anzuzeigen, oder drücken Sie die EINGABETASTE , um die nächste Ausgabezeile anzuzeigen. Drücken Sie Q , um zu beenden.
Das Paging ähnelt dem Befehl "More ".
Hinweis
Der Paging-Parameter wird vom PowerShell-ISE-Host nicht unterstützt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Sie können Objekte in der Pipeline an Out-Hostsenden.
Ausgaben
None
Out-Host generiert keine Ausgabe. Es sendet Objekte zur Anzeige an den Host.
Hinweise
Der Paging-Parameter wird nicht von allen PowerShell-Hosts unterstützt. Wenn Sie beispielsweise den Paging-Parameter in der PowerShell ISE verwenden, wird der folgende Fehler angezeigt: out-lineoutput : The method or operation is not implemented.
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 es das Cmdlet vor dem Rendern an ein Formatierungs-Cmdlet.
Die Out- Cmdlets verfügen nicht über Parameter für Namen oder Dateipfade. Um Daten an ein Out- Cmdlet zu senden, verwenden Sie die Pipeline, um die Ausgabe eines PowerShell-Befehls an das Cmdlet zu senden. Alternativ können Sie Daten in einer Variablen speichern und den InputObject-Parameter verwenden, um die Daten an das Cmdlet zu übergeben.
Out-Host sendet Daten, erzeugt aber keine Ausgabeobjekte. Wenn Sie die Ausgabe von Out-Host an das Get-Member Cmdlet weiterleiten, Get-Member werden keine Objekte angegeben.