Udostępnij za pośrednictwem

Out-Default

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Wysyła dane wyjściowe do domyślnego formatera i do domyślnego polecenia cmdlet wyjściowego.

Składnia

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

Opis

Program PowerShell automatycznie dodaje Out-Default do końca każdego potoku. Out-Default określa sposób formatowania i wyprowadzania strumienia obiektu. Jeśli strumień obiektu jest strumieniem ciągów, Out-Default potoki te bezpośrednio, do Out-Host których są wywoływane odpowiednie interfejsy API dostarczone przez hosta. Jeśli strumień obiektu nie zawiera ciągów, sprawdza obiekt, Out-Default aby określić, co należy zrobić. Najpierw sprawdza typ obiektu i określa, czy istnieje zarejestrowany widok dla tego typu obiektu.

Program PowerShell definiuje schemat XML i mechanizm ( Update-FormatData polecenie cmdlet), w którym każdy może rejestrować widoki dla typu obiektu. Można określić szeroki, listę, tabelę lub widoki niestandardowe dla dowolnego typu obiektu. Widoki określają właściwości do wyświetlenia i sposób ich wyświetlania. Jeśli widok jest zarejestrowany, definiuje, który formater ma być używany. Jeśli więc zarejestrowany widok jest widokiem tabeli , Out-Default przesyła strumieniowo obiekty do Format-Table | Out-Host. Format-Table przekształca obiekty w strumień rekordów formatowania (sterowanych danymi w definicji widoku) i Out-Host przekształca rekordy formatowania w wywołania interfejsu hosta.

To polecenie cmdlet nie jest przeznaczone do użycia przez użytkownika końcowego. Inne polecenia cmdlet są zalecane do kontrolowania danych wyjściowych, takich jak Out-Host lub przy użyciu Format-* poleceń cmdlet i pliku Format.ps1xml w celu kontrolowania formatowania.

Przykłady

Przykład 1

Chociaż to polecenie cmdlet nie ma być uruchamiane bezpośrednio przez użytkownika końcowego, może to być.

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

Błąd nie jest zgłaszany podczas używania, Out-Default ale dane wyjściowe nie są zmieniane, jeśli nie są jawnie wywoływane.

Parametry

-InputObject

Akceptuje dane wejściowe polecenia cmdlet.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Transcript

Określa, czy dane wyjściowe powinny być wysyłane do usług transkrypcji programu PowerShell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False