將輸出傳送到命令列。
語法
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。
請參閱