Out-Host

  • 參考
模組:
Microsoft.PowerShell.Core

將輸出傳送至命令行。

Syntax

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

Description

Cmdlet 會將 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

指定寫入主控台的物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Paging

表示 Out-Host 一次顯示一頁輸出，並在顯示其餘頁面之前等候用戶輸入。 根據預設，所有輸出都會顯示在單一頁面上。 頁面大小取決於主機的特性。

按空格鍵可顯示下一頁的輸出或 Enter 鍵，以檢視下一行輸出。 按 Q 以結束。

分頁類似於更多命令。

注意

PowerShell ISE 主機不支援分頁參數。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

PSObject

您可以使用管線將任何物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。 它會將物件傳送至主機以顯示。

備註

PowerShell 包含下列的 Out-Host別名：

  • 所有平臺：
    • oh

所有 PowerShell 主機都不支援分頁參數。 例如，如果您在PowerShell ISE 中使用 Paging 參數，則會顯示下列錯誤： out-lineoutput : The method or operation is not implemented.

包含 Out 動詞的 Out-Cmdlet 不會格式化物件。 它們會轉譯物件，並將其傳送至指定的顯示目的地。 如果您將未格式化的對象傳送至 Out- Cmdlet，Cmdlet 會在轉譯之前先將它傳送至格式化 Cmdlet。

Cmdlet Out- 沒有名稱或檔案路徑的參數。 若要將數據傳送至 Out- Cmdlet，請使用管線將 PowerShell 命令的輸出傳送至 Cmdlet。 或者，您可以將資料儲存在變數中，並使用 InputObject 參數將數據傳遞至 Cmdlet。

Out-Host 會傳送數據，但不會產生任何輸出物件。 如果您將 的 Out-Host 輸出管線至 Get-Member Cmdlet， Get-Member 則報告尚未指定任何物件。