Freigeben über


Out-Host

Sendet eine Ausgabe an die Befehlszeile.

Syntax

Out-Host
   [-Paging]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Beschreibung

Das Out-Host Cmdlet sendet die Ausgabe für die Anzeige an den PowerShell-Host. Der Host zeigt die Ausgabe in der Befehlszeile an. Da Out-Host die Standardeinstellung ist, müssen Sie sie nicht angeben, es sei denn, Sie möchten die Parameter verwenden.

Out-Host wird automatisch an jeden ausgeführten Befehl angefügt. Sie ü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 gibt ANSI-Escapesequenzen an den Host weiter, 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 Paging-Parameter , 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 gespeichert Out-Hostsind.

$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 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 die Benutzereingabe wartet, bevor die Seiten erneut angezeigt werden Standard 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 "Mehr ".

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

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

PowerShell enthält die folgenden Aliase für Out-Host:

  • Alle Plattformen:
    • oh

Der Paging-Parameter wird von allen PowerShell-Hosts nicht unterstützt. Wenn Sie beispielsweise den Paging-Parameter in 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 das Cmdlet es an ein Formatierungs-Cmdlet, bevor es gerendert wird.

Die Out- Cmdlets verfügen nicht über Parameter für Namen oder Dateipfade. Verwenden Sie die Pipeline, um Daten an ein Out- Cmdlet zu senden, 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 des Out-HostGet-Member Cmdlets weiterleiten, Get-Member werden berichte, dass keine Objekte angegeben wurden.