Out-Host

發行項
10/30/2009

將輸出傳送到命令列。

語法

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。

請參閱

概念

Out-Printer
Out-Null
Out-File
Out-String
Out-Default
Write-Host

共用方式為