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-GridView PassThru 參數可讓您在管線下傳送多個專案。 PassThru 參數相當於使用 OutputMode 參數的 Multiple 值。

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

這個範例示範如何使用 的 Out-GridView Wait 參數，建立視窗的 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-click 和 Ctrl-click。

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 的命令輸出無法使用 Cmdlet 格式化 Format ，例如 Format-Table 或 Format-Wide Cmdlet。 若要選取屬性，請使用 Select-Object Cmdlet。

遠端命令的還原串行化輸出可能無法在方格檢視視窗中正確格式化。

的鍵盤快捷方式Out-GridView

使用此機碼：	若要執行此動作：
定位字元	將游標從 [篩選] 方塊移至 [新增準則] 功能表至數據表和返回。
UpArrow	向上移動一個數據列。 從第一個數據列移至數據行標頭。
DownArrow	向下移動一列。
LeftArrow	在資料行行首列中，將左移一個數據行。
RightArrow	在數據行標頭數據列中，向右移動一個數據行。
ContextMenuKey	在資料行行首列中，顯示 [選取數據行] 選項。
Enter 或 空格鍵	在數據行標頭數據列中，排序數據行數據（切換 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