Out-GridView
將輸出傳送至個別視窗中的互動式數據表。
語法
PassThru (預設值)
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-PassThru]
[<CommonParameters>]
Wait
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-Wait]
[<CommonParameters>]
OutputMode
Out-GridView
[-InputObject <PSObject>]
[-Title <String>]
[-OutputMode <OutputModeOption>]
[<CommonParameters>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
Out-GridView Cmdlet 會將命令的輸出傳送至網格線檢視視窗，其中輸出會顯示在互動式數據表中。
由於此 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
Get-Process Cmdlet 的輸出會儲存在 $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，這是 Out-GridView Cmdlet 的別名。
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 參數相當於使用 OutputMode 參數的 Multiple 值。
範例 8：建立 'Out-GridView' 的 Windows 快捷方式
此範例示範如何使用 的 Out-GridView 參數，建立 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。
參數屬性
| 類型: | PSObject |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OutputMode
指定互動式視窗將管線向下傳送為輸入給其他命令的專案。 根據預設，此 Cmdlet 不會產生任何輸出。 若要從互動式視窗向下傳送專案，請按下 以選取專案，然後按兩下 [確定]。
此參數的值會決定您可以向下傳送管線的項目數目。
-
None。 沒有專案。 這是預設值。 -
Single。 零個專案或一個專案。 當下一個命令只能接受一個輸入物件時，請使用此值。 -
Multiple。 零、一或多個專案。 當下一個命令可以接受多個輸入物件時，請使用此值。 此值相當於 passThru 參數。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | OutputModeOption |
| 預設值: | None |
| 接受的值: | None, Single, Multiple |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
OutputMode
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PassThru
指出 Cmdlet 會將專案從互動式視窗向下傳送至管線做為其他命令的輸入。 根據預設，此 Cmdlet 不會產生任何輸出。 此參數相當於使用 OutputMode 參數的 Multiple 值。
若要從互動式視窗向下傳送專案，請按下 以選取專案，然後按兩下 [確定]。 支援 Shift-click 和 Ctrl-click。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PassThru
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Title
指定出現在 Out-GridView 視窗標題列中的文字。 根據預設，標題欄會顯示叫用 Out-GridView的命令。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Wait
表示 Cmdlet 會隱藏命令提示字元，並防止 Windows PowerShell 關閉，直到關閉 Out-GridView 視窗為止。 根據預設，命令提示字元會在開啟 Out-GridView 視窗時傳回。
此功能可讓您在 Windows 快捷方式中使用 Out-GridView Cmdlet。 在沒有 Out-GridView 參數的快捷方式中使用 時，powerShell 關閉之前，Out-GridView 視窗只會立即出現。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Wait
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
PSObject
您可以將任何物件通過管道傳遞至此命令工具。
輸出
None
根據預設，此 Cmdlet 不會傳回任何輸出。
PSObject
當您使用 PassThru 參數時，這個 Cmdlet 會傳回代表所選取數據列的物件。
備註
PowerShell 包含下列 Out-GridView的別名：
- 窗戶：
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）。 |
如何使用網格線檢視視窗功能
隱藏或顯示資料行：
- 以滑鼠右鍵按下任何資料列標頭，然後按下 [選取資料列。
- 在 [選取數據行] 對話框中，使用箭頭鍵將 [選取的數據行] 之間的數據行移至 [可用的數據行] 方塊。 只有 [選取數據行] 方塊 中的數據行才會出現在方格檢視視窗中。
重新排序數據行：
您可以將資料行拖放到所需的位置。 或使用下列步驟：
- 以滑鼠右鍵按下任何資料列標頭，然後按下 [選取資料列。
- 在 [選取數據行] 對話框中，使用 [上移，下移 按鈕來重新排序數據行。 清單頂端的數據行會顯示在方格檢視視窗中清單底部的數據行左邊。
如何排序數據表數據
- 若要排序數據，請按下數據行標頭。
- 若要變更排序順序，請再次按下數據行標頭。 每次按一下相同的標頭時，排序順序會在遞增至遞減順序之間切換。 目前的順序是由數據行標頭中的三角形表示。
如何選取數據表數據
- 若要選取數據列，請選取資料列，或使用向上或向下箭號來流覽至數據列。
- 若要選取所有數據列（標頭數據列除外），請按 CTRL+A。
- 若要選取連續的數據列，請在按兩下資料列或使用箭頭鍵時按住 SHIFT 鍵。
- 若要選取非連續的數據列，請按 CTRL 鍵，然後按兩下以將數據列新增至選取範圍。
- 您無法選取資料行，而且無法選取整個資料行行首數據列。
如何複製數據列
若要從數據表複製一或多個數據列，請選取數據列，然後按 CTRL+C。
您可以將資料貼到任何文字或電子錶格程式中。 您無法複製資料列或資料列的一部分，也無法複製資料行行首數據列。
如何在數據表中搜尋 （快速篩選）
使用 [篩選] 方塊來搜尋數據表中的數據。 當您在方塊中輸入時，只有包含具類型文字的專案會出現在數據表中。
搜尋文字。 若要搜尋數據表中的文字，請在 [篩選] 方塊中輸入要尋找的文字。
搜尋多個單字。 若要搜尋數據表中的多個單字，請輸入以空格分隔的字組。
Out-GridView會顯示包含所有字組的數據列（邏輯 AND）。搜尋常值片語。 若要搜尋包含空格或特殊字元的片語，請用引號括住片語。
Out-GridView會顯示包含片語完全相符的數據列。在數據行中搜尋。 若要搜尋一或多個資料列中的文字，請使用下列格式：
<column>:<text> [<column>:<text>] ...例如，若要在 DisplayName 數據行中找到 “Net”，請在 [Filter] 方塊中輸入：
displayname:net若要在 DisplayName 和 Name 數據行中尋找具有 “Net” 的數據列，請在 [篩選] 方塊中輸入：
displayname:net name:net關閉搜尋。 若要再次顯示整個數據表，請按下 篩選 方塊右上角的紅色 X 按鈕，或從 [篩選] 方塊中刪除文字。
使用準則篩選數據表
您可以使用規則或準則來判斷資料表中顯示的專案。 只有在專案符合您建立的所有準則時才會顯示。 可用的準則取決於方格檢視視窗中所顯示之對象的屬性，以及這些屬性的 .NET Framework 類型。
每個準則都有下列格式：
<column> <operator> <value>
不同屬性的準則會透過 AND連接。 相同屬性的準則會透過 OR連接。 您無法變更邏輯連接器。
準則只會影響顯示。 它不會刪除資料表中的專案。
如何新增準則
- 若要顯示 [新增準則] 功能表按鈕，請按下視窗右上角的 [展開] 箭號。
- 按兩下 [新增準則] 功能表按鈕。
- 按兩下即可選取資料行（屬性）。 您可以選取一或多個屬性。
- 當您完成選取屬性時，請按兩下 [新增 ] 按鈕。
- 若要取消新增專案，請按下 [取消] 。
- 若要新增更多準則，請再次按兩下 [新增準則 ] 按鈕。
如何編輯準則
- 若要變更運算符，請按下藍色運算子值，然後從下拉式清單中選取不同的運算符。
- 若要輸入或變更值，請在值方塊中輸入值。 如果您輸入無效的值，就會顯示圓形 X 圖示。 若要移除它，請變更值。
- 若要建立 OR 語句，請新增具有相同屬性的準則。
如何刪除準則
- 若要刪除選取的準則，請按兩下每個準則旁邊的紅色 X。
- 若要刪除所有準則，請按兩下 [清除所有 ] 按鈕。
