共用方式為

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 使用 Paging 參數一次顯示一頁的數據。

範例 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

您可以將物件向下傳送至 Out-Host。

輸出

None

Out-Host 不會產生任何輸出。 它會將物件傳送至主機以供顯示。

備註

所有 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 則報告未指定任何物件。