Out-Default
將輸出傳送至預設格式器,並將 輸出傳送至預設輸出 Cmdlet。
語法
Default (預設值)
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 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Transcript
判斷輸出是否應該傳送至 PowerShell 的轉譯服務。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。