共用方式為

Out-Default

  • 參考
模組:
Microsoft.PowerShell.Core

將輸出傳送到預設的格式器和預設的輸出 Cmdlet。

語法

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

Description

PowerShell 會自動新增 Out-Default 至每個管線的結尾。 Out-Default 決定如何格式化和輸出對象數據流。 如果對象數據流是字串數據流， Out-Default 請直接將這些串流傳送至 Out-Host 該數據流，以呼叫主機所提供的適當 API。 如果對象數據流不包含字串， Out-Default 請檢查 對象以判斷該怎麼做。 首先，它會查看物件類型，並判斷這個物件類型是否有已註冊 的檢視 。

PowerShell 會定義 XML 架構和機制 （ Update-FormatData Cmdlet），讓任何人都可以註冊物件類型的檢視。 您可以指定 任何物件類型的寬、 清單、 資料表或 自定義 檢視。 檢視會指定要顯示的屬性及其顯示方式。 如果已註冊檢視，它會定義要使用的格式器。 因此，如果已註冊的檢視是 數據表 檢視， Out-Default 請將 物件串流至 Format-Table | Out-Host。 Format-Table 將物件轉換成格式化記錄數據流（由檢視定義中的數據驅動），並將 Out-Host 格式化記錄轉換成主機介面上的呼叫。

此 Cmdlet 並非供使用者使用。 建議使用其他 Cmdlet 來控制輸出，例如 Out-Host 或使用 Format-* Cmdlet 和 Format.ps1xml 檔案來控制格式。

範例

範例 1

雖然此 Cmdlet 並非要由使用者直接執行，但可能是。

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

使用 Out-Default 時不會擲回任何錯誤，但如果未明確呼叫，則不會變更輸出。

參數

-InputObject

接受 Cmdlet 的輸入。

類型:PSObject
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Transcript

判斷輸出是否應該傳送至 PowerShell 的轉譯服務。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False