Out-Host
將輸出傳送到命令列。
語法
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
Out-Host指令長會將輸出傳送到 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 顯示一頁輸出。 頁面大小由主機的特性決定。
輸出第一頁後，指令會等待使用者輸入，然後再顯示剩餘頁面。 按 空白鍵 顯示下一頁輸出，按 Enter 鍵查看下一行輸出。 按 Q 鍵退出。
使用 分頁 功能類似於使用 更多 指令。
Note
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
您可以將任何物件通過管道傳遞至此命令工具。
輸出
None
此 Cmdlet 不會傳回任何輸出。 它會將物件傳送給主機以供顯示。
備註
PowerShell 包含下列 Out-Host的別名：
- 所有平臺：
oh
並非所有 PowerShell 主機都支援 分頁 參數。 例如，如果您在 Windows PowerShell ISE 中使用 Paging 參數，會顯示以下錯誤：
out-lineoutput：未實作方法或操作。
包含 Out 動詞 Out-的 cmdlet 不會格式化物件。 它們渲染物件並將其傳送到指定的顯示目的地。 如果你把一個未格式化的物件傳送給 Out- cmdlet，該 cmdlet 會在渲染前先把它傳送到格式化 cmdlet。
指令 Out- 長子不會讀取檔案的輸入。 要將資料傳送到 Out- cmdlet，請使用管線將資料傳送給 cmdlet。 或者，你可以把資料存進變數，然後用 InputObject 參數把資料傳給 cmdlet。
Out-Host 只傳送資料給主機。 Tt 不會產生輸出物件到管線。 如果你把輸出 Out-Host 管線輸出到 Get-Member cmdlet，報告 Get-Member 說沒有指定任何物件。
