Out-Default
將輸出傳送至預設格式器,並將 輸出傳送至預設輸出 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 |