將輸出傳送到命令列。

語法

Out-Host [-InputObject <psobject>] [-Paging] [<CommonParameters>]

描述

Out-Host Cmdlet 會將輸出傳送到 Windows PowerShell 主機以供顯示。主機會在命令列中顯示輸出。因為 Out-Host 是預設值,所以除非您要使用其參數來變更顯示,否則不需要另外指定。

參數

-InputObject <psobject>

指定要寫入主控台的物件。請輸入包含物件的變數,或輸入可取得物件的命令或運算式。

必要?

false

位置?

named

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-Paging

一次顯示一頁輸出,並等待使用者輸入後再顯示其餘頁面,就像傳統的 "more" 命令。預設情況下,會以一頁顯示所有的輸出。頁面大小取決於主機的特性。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSObject

您可經由管道將任何物件輸出至 Out-Host。

輸出

Out-Host 不會產生任何輸出。不過,主機可能會顯示 Out-Host 傳送給它的物件。

附註

您也可以利用內建的別名 "oh" 來參照 Out-Host。如需詳細資訊,請參閱 about_Aliases。

包含 Out 動詞的 Cmdlet (Out Cmdlet) 不會將物件格式化,而是單僅轉譯物件再傳送到指定的顯示目的地。若將尚未格式化的物件傳送給 Out cmdlet,cmdlet 便會在轉譯前先將物件傳送給格式化 cmdlet。

Out cmdlet 沒有名稱參數或檔案路徑參數。若要傳送資料給 Out Cmdlet,請使用管線運算子 (|) 將 Windows PowerShell 命令的輸出傳送給 Cmdlet。您也可以將資料儲存至變數,再使用 InputObject 參數將資料傳遞給 cmdlet。如需說明,請參閱範例。

Out-Host 會傳送資料,但是不會發出任何輸出物件。如果您經由管道將 Out-Host 的輸出輸出至 Get-Member,Get-Member 就會報告尚未指定物件的狀況。

範例 1

C:\PS>get-process | out-host -paging

描述
-----------
這個命令以一次一頁的方式顯示系統中的處理序。它會使用 Get-Process 命令來取得系統中的處理序。管線運算子 (|) 會將結果傳送到 Out-Host,後者再將它們顯示於主控台。Paging 參數會一次顯示一頁的資料。

Windows PowerShell 的內建 Help 函數也使用相同的命令格式。該函數會使用下列命令格式從 Get-Help 取得資料,然後使用 Out-Host 的 Paging 參數以一次一頁的方式顯示資料:get-help $args[0] | out-host -paging)。






範例 2

C:\PS>$a = get-history

C:\PS>out-host -InputObject $a

描述
-----------
這些命令會在命令列顯示工作階段歷程記錄。第一個命令使會用 Get-History Cmdlet 來取得工作階段歷程記錄,然後將歷程記錄儲存在 $a 變數中。第二個命令會使用 Out-Host 來顯示 $a 變數的內容,並使用 InputObject 參數,將此變數指定給 Out-Host。






請參閱




目錄