Freigeben über

Out-Default

  • Referenz
Modul:
Microsoft.PowerShell.Core

Sendet die Ausgabe an den Standardformatierer und an das Standardausgabe-Cmdlet.

Syntax

Out-Default
   [-Transcript]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Beschreibung

PowerShell fügt am Ende jeder Pipeline automatisch Out-Default hinzu. Out-Default entscheidet, wie der Objektdatenstrom formatiert und ausgegeben wird. Wenn der Objektdatenstrom ein Zeichenfolgendatenstrom ist, leitet Out-Default diesen direkt an Out-Host weiter, die die entsprechenden vom Host bereitgestellten APIs aufruft. Wenn der Objektdatenstrom keine Zeichenfolgen enthält, prüft Out-Default das Objekt, um zu bestimmen, was zu tun ist. Zunächst wird der Objekttyp untersucht und bestimmt, ob eine registrierte Ansicht für diesen Objekttyp vorhanden ist.

PowerShell definiert ein XML-Schema und einen Mechanismus (das cmdlet Update-FormatData), bei dem jeder Ansichten für einen Objekttyp registrieren kann. Sie können breite, Listen-, Tabellen- oder benutzerdefinierte Ansichten für jeden Objekttyp angeben. Die Ansichten geben an, welche Eigenschaften angezeigt werden sollen und wie sie angezeigt werden sollen. Wenn eine Ansicht registriert ist, definiert sie, welcher Formatierer verwendet werden soll. Wenn die registrierte Ansicht also eine Tabelle Ansicht ist, streamt Out-Default die Objekte nach Format-Table | Out-Host. Format-Table transformiert die Objekte in einen Datenstrom von Formatierungsdatensätzen (gesteuert durch die Daten in der Ansichtsdefinition) und Out-Host die Formatierungseinträge in Aufrufe der Hostschnittstelle transformiert.

Dieses Cmdlet ist nicht für die Verwendung durch den Endbenutzer vorgesehen. Andere Cmdlets werden empfohlen, um die Ausgabe wie mit Out-Host zu steuern. Format-*-Cmdlets und die Datei Format.ps1xml empfehlen sich zum Steuern der Formatierung.

Beispiele

Beispiel 1

Obwohl dieses Cmdlet nicht direkt von Endbenutzer*innen ausgeführt werden sollte, ist das möglich.

Get-Process | Select-Object -First 5 | Out-Default

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     12     2.56       5.20       0.00    7376   0 aesm_service
     48    34.32      18.10      26.64    9320  13 AlertusDesktopAlert
     24    13.97      12.74       0.77   12656  13 ApplicationFrameHost
      8     1.79       4.41       0.00    8180   0 AppVShNotify
      9     1.99       5.07       0.19   19320  13 AppVShNotify

Beim Verwenden von Out-Default wird kein Fehler ausgelöst, die Ausgabe wird jedoch nicht geändert, wenn sie nicht explizit aufgerufen wird.

Parameter

-InputObject

Akzeptiert Eingaben für das Cmdlet.

Typ:PSObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Transcript

Bestimmt, ob die Ausgabe an die Transkriptionsdienste von PowerShell gesendet werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False