Out-Host
將輸出傳送至命令行。
語法
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
Out-Host Cmdlet 會將輸出傳送至 PowerShell 主機以供顯示。 主機會在命令行顯示輸出。 因為 Out-Host 是預設值，除非您想要使用其參數，否則不需要指定它。
Out-Host 會自動附加至執行的每個命令。 它會將管線的輸出傳遞至執行命令的主機。
Out-Host 會忽略 ANSI 逸出序列。 逸出序列是由主機處理。
Out-Host 會將 ANSI 逸出序列傳遞至主機，而不需要嘗試解譯或變更它們。
範例
範例 1：一次顯示一頁輸出
本範例會顯示系統一次處理一頁。
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process 取得系統進程，並將對象傳送至管線。
Out-Host 使用 分頁 參數，一次顯示一頁的數據。
範例 2：使用變數作為輸入
這個範例會使用儲存在變數中的 對象作為 Out-Host的輸入。
$io = Get-History
Out-Host -InputObject $io
Get-History 取得 PowerShell 工作階段的歷程記錄，並將物件儲存在 $io 變數中。
Out-Host 使用 InputObject 參數來指定 $io 變數並顯示歷程記錄。
參數
-InputObject
指定寫入主控台的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。
參數屬性
| 類型: | PSObject |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Paging
表示 Out-Host 一次顯示一頁輸出，並在顯示其餘頁面之前等候用戶輸入。 根據預設，所有輸出都會顯示在單一頁面上。 頁面大小取決於主機的特性。
按 Space 列以顯示下一頁的輸出或 Enter 鍵，以檢視下一行輸出。 按 Q 結束。
分頁 類似於 命令。
備註
PowerShell ISE 主機不支援 分頁 參數。
參數屬性
| 類型: | 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。
輸入
PSObject
您可以沿管道 Out-Host將物件傳送到 。
輸出
None
Out-Host 不會產生任何輸出。 它會將物件傳送至主機以顯示。
備註
所有 PowerShell 主機都不支援 分頁 參數。 例如，如果您在PowerShell ISE 中使用 分頁 參數，則會顯示下列錯誤：out-lineoutput : The method or operation is not implemented.
包含 Out 動詞命令 Out-的 Cmdlet 不會格式化物件。 它們會轉譯物件，並將其傳送至指定的顯示目的地。 如果您將未格式化的物件傳送到 Out- Cmdlet，該 Cmdlet 會在轉譯之前將其傳送到格式化 Cmdlet。
Out- Cmdlet 沒有名稱或檔案路徑的參數。 若要將數據傳送至 Out- Cmdlet，請使用管線將 PowerShell 命令的輸出傳送至 Cmdlet。 或者，您可以將數據儲存在變數中，並使用 InputObject 參數，將數據傳遞至 Cmdlet。
Out-Host 傳送數據，但不會產生任何輸出物件。 如果您將 Out-Host 的輸出管線至 Get-Member Cmdlet，Get-Member 報告尚未指定任何物件。