Out-GridView

模組:

Microsoft.PowerShell.Utility

將輸出傳送到另一個視窗中的互動式表格。

Syntax

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-PassThru]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-Wait]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-OutputMode <OutputModeOption>]
   [<CommonParameters>]

Description

此 Cmdlet 僅適用於 Windows 平臺。

Cmdlet 會將 Out-GridView 命令的輸出傳送至網格線檢視視窗，其中輸出會顯示在互動式數據表中。

因為此 Cmdlet 需要使用者介面，所以無法在 Windows Server Core 或 Windows Nano Server 上運作。

您可以使用下列表格功能來檢查您的資料：

• 隱藏、顯示及重新排序數據行
• 排序數據列
• 快速篩選
• 新增準則篩選
• 複製和貼上

如需完整指示，請參閱本文的 附注 一節。

注意

此 Cmdlet 已在 PowerShell 7 中重新引進。 此 Cmdlet 僅適用於支援 Windows 桌面的 Windows 系統上。 如需此 Cmdlet 的跨平臺版本，請參閱 PowerShell 資源庫 中的 ConsoleGuiTools 模組。

範例

範例 1：將進程輸出至方格檢視

本範例會取得在本機計算機上執行的進程，並將其傳送至方格檢視視窗。

Get-Process | Out-GridView

範例 2：使用變數將進程輸出至方格檢視

這個範例也會取得在本機計算機上執行的進程，並將其傳送至方格檢視視窗。

$P = Get-Process
$P | Out-GridView

Cmdlet 的 Get-Process 輸出會儲存在變數中 $P 。 然後， $P 管線傳送至 Out-GridView。

範例 3：在方格檢視中顯示選取的屬性

本範例會在方格檢視中顯示執行中進程的選取屬性。

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

的輸出 Get-Process 會傳送至 Select-Object ，以選取 Name、 WorkingSet 和 PeakWorkingSet 屬性。 另一個管線運算符會將篩選的物件傳送至 Sort-Object Cmdlet，依 WorkingSet 屬性的值以遞減順序排序它們。 然後，排序的結果會以管線傳送至 Out-GridView。 您現在已經可以使用資料格檢視的功能來搜尋、排序及篩選資料。

範例 4：將輸出儲存至變數，然後輸出方格檢視

本範例會將 Cmdlet 輸出儲存在變數中，然後將它傳送至 Out-GridView。

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem 會使用 $PSHOME 自動變數，取得 PowerShell 安裝目錄中的所有檔案及其子目錄。 命令中的括號會確立操作的順序。 因此，命令的 Get-ChildItem 輸出會先儲存在變數中 $A ，再傳送至 Out-GridView。

範例 5：將指定計算機的輸出進程傳送至方格檢視

本範例會顯示在方格檢視視窗中的 Server01 計算機上執行的進程。

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

此範例使用 ogv，這是 Cmdlet 的 Out-GridView 別名。 Title 參數會指定視窗標題。

範例 6：將資料從遠端電腦輸出至方格檢視

這個範例示範如何將從遠端電腦收集的資料傳送至 Out-GridView。

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command 會在三部遠端電腦上執行 Get-Culture 。 產生的數據會以管線傳送至 Out-GridView。 請注意，在遠端電腦上執行的腳本區塊不包含 Out-GridView 命令。 如果有包含，當此命令嘗試在每一部遠端電腦上開啟資料格檢視視窗時，將會失敗。

範例 7：透過 'Out-GridView' 傳遞多個專案

此範例可讓您從 Out-GridView 視窗中選取多個進程。 您選取的進程會傳遞至 Export-Csv 命令，並寫入檔案 ProcessLog.csv 。

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

的 Out-GridViewPassThru 參數可讓您將多個項目傳送至管線。 PassThru 參數等同於使用 OutputMode 參數的 Multiple 值。

範例 8：Create 'Out-GridView' 的 Windows 快捷方式

此範例示範如何使用 的 Out-GridViewWait 參數來建立視窗的 Out-GridView Windows 快捷方式。

pwsh -Command "Get-Service | Out-GridView -Wait"

此命令行可用於 Windows 快捷方式。 如果沒有 Wait 參數，PowerShell 會在開啟視窗時 Out-GridView 立即結束，這幾乎會立即關閉 Out-GridView 視窗。

參數

-InputObject

指定 Cmdlet 接受做為 輸入的物件 Out-GridView。

當您使用 InputObject 參數將物件集合傳送至 Out-GridView時， Out-GridView 會將集合視為一個集合物件，並顯示一個代表集合的數據列。 若要顯示集合中的每個物件，請使用管線運算子 (|) 將物件傳送至 Out-GridView。

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

-OutputMode

指定互動式視窗將管線當做輸入傳送至其他命令的專案。 根據預設，此 Cmdlet 不會產生任何輸出。 若要從互動式視窗將項目沿著管線向下傳送，請按一下項目來進行選取，然後按一下 [確定]。

這個參數的值會決定您可以沿著管線向下傳送的項目數。

• None. 沒有項目。 這是預設值。
• Single. 零個項目或一個項目。 如果下一個命令只能接受一個輸入物件，請使用這個值。
• Multiple. 零個、一個或許多個項目。 如果下一個命令可以接受多個輸入物件，請使用這個值。 這個值相當於 Passthru 參數。

此參數是在 Windows PowerShell 3.0 引進。

Type:	OutputModeOption
Accepted values:	None, Single, Multiple
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

表示 Cmdlet 會將專案從互動式視窗向下傳送為其他命令的輸入。 根據預設，此 Cmdlet 不會產生任何輸出。 這個參數等同於使用 OutputMode 參數的 Multiple 值。

若要從互動式視窗將項目沿著管線向下傳送，請按一下項目來進行選取，然後按一下 [確定]。 支援按住 Shift 鍵並按一下滑鼠左鍵及按住 Ctrl 鍵並按一下滑鼠左鍵來進行選取。

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

-Title

指定出現在視窗標題列中的 Out-GridView 文字。 根據預設，標題欄會顯示叫用 的 Out-GridView命令。

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

-Wait

表示 Cmdlet 會隱藏命令提示字元，並防止 Windows PowerShell 關閉，直到Out-GridView視窗關閉為止。 根據預設，命令提示字元會在窗口開啟時 Out-GridView 傳回。

此功能可讓您在 Windows 快捷方式中使用 Out-GridView Cmdlet。 在不含 Wait 參數的快捷方式中使用 時Out-GridView，Out-GridView視窗只會在 PowerShell 關閉之前立即出現。

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

輸入

PSObject

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

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

PSObject

當您使用 PassThru 參數時，此 Cmdlet 會傳回代表所選取數據列的物件。

備註

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

• Windows：
  • ogv

此 Cmdlet 僅適用於 Windows 平臺。 此 Cmdlet 僅適用於 Windows 平臺。

您無法使用遠端命令在另一部電腦上開啟資料格檢視視窗。

您傳送至 Out-GridView 的 Format 命令輸出無法使用 Cmdlet 格式化，例如 Format-Table 或 Format-Wide Cmdlet。 若要選取屬性，請使用 Select-Object Cmdlet。

來自遠端命令的已還原序列化輸出在資料格檢視中可能無法正確格式化。

的鍵盤快捷方式Out-GridView

使用此按鍵：	可執行此動作：
Tab	將游標從 [ 篩選 ] 方塊移至 [ 新增準則 ] 功能表，然後返回數據表。
UpArrow	向上移動一列。 從數據的第一個數據列移至數據行標頭。
DownArrow	向下移動一列。
LeftArrow	在資料列標題資料列中，將左移一個數據行。
RightArrow	在數據行標頭數據列中，向右移動一個數據行。
ContextMenuKey	在數據列標頭資料列中，顯示 [選取資料行] 選項。
輸入 或 空格鍵	在數據行標頭數據列中，排序數據行數據 (切換 A-Z、Z-A) 。

如何使用方格檢視視窗功能

隱藏或顯示欄位：

1. 以滑鼠右鍵按下任何數據行標頭，然後按兩下 [ 選取數據行]。
2. 在 [ 選取數據行] 對話框中，使用箭頭鍵，將 [選取的數據行] 之間的數據行移至 [可用的數據行] 方塊。 [ 選取資料行] 方塊中的數據行只會出現在方格檢視視窗中。

重新排列欄位：

您可以將資料行拖放到所需的位置。 或使用下列步驟：

1. 以滑鼠右鍵按下任何數據行標頭，然後按兩下 [ 選取數據行]。
2. 在 [ 選取資料行] 對話框中，使用 [上移 ] 和 [ 下移 ] 按鈕來重新排序數據行。 清單頂端的欄位在資料格檢視視窗中會顯示在清單底部欄位的左邊。

如何排序表格資料

• 若要排序資料，請按一下欄標題。
• 若要變更排序順序，請再按一下欄標題。 每次按一下相同的標題，排序順序就會在遞增順序與遞減順序之間切換。 欄標題中的三角形表示目前的順序。

如何選取表格資料

• 若要選取資料列，請選取資料列，或使用向上或向下箭號瀏覽至數據列。
• 若要選取標頭數據列) 以外的所有數據列 (，請按 CTRL+A。
• 若要選取連續的數據列，請在按兩下資料列或使用箭頭鍵時按住 SHIFT 鍵。
• 若要選取非連續的數據列，請按 CTRL 鍵，然後按下 以將數據列新增至選取範圍。
• 您無法選取欄位，也無法選取整個欄標題列。

如何複製列

• 若要從表格複製一列或多列，請選取那些列，然後按 CTRL+C。

  您可以將資料貼到任何文字或試算表程式中。 您無法複製欄位或或列的部分，也無法複製欄標題列。

如何在數據表中 搜尋 (快速篩選)

使用 [篩選] 方塊來搜尋數據表中的數據。 在方塊中輸入時，只有包含輸入之文字的項目才會顯示在表格中。

• 搜尋文字。 若要搜尋表格中的文字，請在 [篩選] 方塊中輸入要尋找的文字。

• 搜尋多個字。 若要搜尋表格中的多個字，請輸入文字並以空格分隔。 Out-GridView 會顯示包含邏輯 AND) 之所有字組的數據列 (。

• 搜尋片語。 若要搜尋包含空格或特殊字元的片語，請以引號括住該片語。 Out-GridView 會顯示包含片語完全相符的數據列。

• 在欄位中搜尋。 若要在一個或多個欄位中搜尋文字，請使用下列格式：

  <column>:<text> [<column>:<text>] ...

  例如，若要在 DisplayName 數據行中找到 “Net”，請在 [ 篩選 ] 方塊中輸入：

  displayname:net

  若要在 DisplayName 和 Name 資料行中尋找具有 “Net” 的數據列，請在 [ 篩選 ] 方塊中輸入：

  displayname:net name:net

• 關閉搜尋。 若要再次顯示整個數據表，請按兩下 [ 篩選 ] 方塊右上角的紅色 X 按鈕，或刪除 [ 篩選 ] 方塊中的文字。

使用條件來篩選表格

您可以使用規則或準則來判斷資料表中顯示的專案。 只有在專案符合您建立的所有準則時才會顯示。 可用的條件取決於資料格檢視視窗中所顯示之物件的屬性，以及這些屬性的 .NET Framework 類別。

每個條件都具有下列格式：

<column> <operator> <value>

不同屬性的準則是由 AND 連接。 相同屬性的準則是由 OR 連接。 您無法變更邏輯連接子。

條件只會影響顯示。 它不會將項目從表格中刪除。

如何新增條件

1. 若要顯示 [ 新增準則 ] 功能表按鈕，請按下視窗右上角的 [展開] 箭號。
2. 按兩下 [ 新增準則] 選單按鈕。
3. 按一下來選取欄位 (屬性)。 您可以選取一個或多個屬性。
4. 當您完成選取屬性時，請按下 [ 新增 ] 按鈕。
5. 若要取消新增專案，請按兩下 [ 取消]。
6. 若要新增更多準則，請按兩下 [ 新增準則 ] 按鈕。

如何編輯條件

• 若要變更運算符，請按下藍色運算子值，然後從下拉式清單中選取不同的運算符。
• 若要輸入或變更某個值，請在值方塊中輸入值。 如果輸入的值無效，就會顯示圓形的 X 圖示。 若要將它移除，請變更該值。
• 若要建立 OR 語句，請新增具有相同屬性的準則。

如何刪除條件

• 若要刪除選取的條件，請按一下每個條件旁邊的紅色 X。
• 若要刪除所有準則，請按兩下 [ 全部清除] 按鈕。

相關連結

• Out-File
• Out-Printer
• Out-String