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
Out-GridView Cmdlet 會將命令的輸出傳送至互動式數據表中顯示輸出的方格檢視視窗。
由於此 Cmdlet 需要使用者介面，所以無法在 Windows Server 的 Server Core 安裝上運作。
您可以使用資料表的下列功能來檢查您的資料：
- 隱藏、顯示和重新排序列：要隱藏、顯示或重新排序列，請右鍵按下列標題，然後按兩下 Select Columns（選擇列）。
- 排序。 若要排序數據，請按下數據行標頭。 再次按下即可從遞增切換為遞減順序。
- 快速篩選。 使用窗口頂部的 Filter 框搜尋表中的文字。 您可以搜尋特定數據行中的文字、搜尋常值，以及搜尋多個單字。
- 準則篩選。 使用 Add criteria 下拉功能表創建規則以篩選數據。 這非常適用於非常大型的數據集，例如事件記錄檔。
- 複製並貼上。 若要從 Out-GridView 複製資料行，請按 Ctrl+C （複製） 。 您可以將資料貼到任何文字或電子錶格程式中。
有關使用這些功能的說明，請鍵入 Get-Help Out-GridView -Full 並參閱 Notes 部分中的如何使用 Grid View 視窗功能。
範例
範例 1：將處理程序輸出至方格檢視
PS C:\> Get-Process | Out-GridView
此命令會取得在本機計算機上執行的進程，並將其傳送至方格檢視視窗。
範例 2：使用變數將進程輸出至方格檢視
PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView
此命令也會取得在本機計算機上執行的進程，並將其傳送至方格檢視視窗。
第一個命令使用 Get-Process cmdlet 獲取電腦上的進程，然後將進程物件保存在 $P 變數中。
第二個命令使用管道運算符將 $P 變數發送到 Out-GridView。
範例 3：在網格檢視中顯示帶格式的表
PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView
此命令會在方格檢視視窗中顯示格式化的數據表。
它會使用 Get-Process Cmdlet 來取得電腦上的進程。
然後，它會使用管線運算符 （|） 將進程對象傳送至 Select-Object Cmdlet。
此命令會使用 select-Object
另一個管道作員將篩選的對象發送到 Sort-Object cmdlet，後者按 WorkingSet 屬性的值對它們進行降序排序。
命令的最後一個部分會使用管線運算子 （|） 將格式化數據表傳送至 out-GridView 。
您現在可以使用方格檢視的功能來搜尋、排序及篩選數據。
範例 4：將輸出儲存至變數，然後輸出方格檢視
PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView
這個指令會將輸出儲存在變數中，並將它傳送至 out-GridView 。
此命令會使用 Get-ChildItem Cmdlet 來取得 Windows PowerShell 安裝目錄中及其子目錄中的檔案。 安裝目錄的路徑會儲存在$pshome自動變數中。
該命令使用賦值運算子 （=） 將輸出保存在 $A 變數中，並使用管道運算符 （|） 將輸出發送到 Out-GridView。
命令中的括弧會建立作業順序。 因此，Get-ChildItem 命令的輸出在發送到 Out-GridView 之前保存在 $A 變數中。
範例 5：將指定計算機的輸出進程輸出至方格檢視
PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"
此命令會顯示在方格檢視視窗中的 Server01 計算機上執行的進程。
該命令使用 ogv，這是 Out-GridView cmdlet 的內置別名，它使用 Title 參數指定視窗標題。
範例 6：將資料從遠端電腦輸出到方格檢視
PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView
此範例顯示從遠端計算機將數據傳送至 out-GridView Cmdlet
此命令會使用 Invoke-Command Cmdlet，在三部遠端電腦上執行 Get-Culture 命令。
它會使用管線運算符，將傳回的數據傳送至 out-GridView Cmdlet
請注意，包含遠端執行的命令的腳本區塊不包含 out-GridView 命令
示例 7：通過 Out-GridView 傳遞多個專案
PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv
此命令可讓您從 [Out-GridView] 視窗中選取多個進程。 您選取的進程會傳遞至 Export-Csv 命令，並寫入 ProcessLog.csv 檔案。
此命令會使用 Out-GridViewPassThru 參數，這可讓您將多個專案傳送至管線。 PassThru 參數等效於使用 OutputMode 參數的 Multiple 值。
示例 8：創建 Windows 快捷方式以 Out-GridView
PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"
此命令示範如何使用 Out-GridView 的 Wait 參數，建立 Out-GridView 視窗的 Windows 快捷方式。 如果沒有 Wait 參數，Windows 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 不會產生任何輸出。 若要從互動式視窗向下傳送專案，請按下 以選取專案，然後按兩下 [確定]。
此參數的值會決定您可以向下傳送管線的項目數目。
- 沒有。 沒有專案。 這是預設值。
- 單一。 零個專案或一個專案。 當下一個命令只能接受一個輸入物件時，請使用此值。
- 倍數。 零、一或多個專案。 當下一個命令可以接受多個輸入物件時，請使用此值。 這個值相當於 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。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | 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 用於沒有 Wait 參數的快捷方式時，Out-GridView 視窗只會在 Windows PowerShell 關閉前立即顯示。
此參數是在 Windows PowerShell 3.0 中引進的。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | 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
您可以將任何物件發送到此 cmdlet。
輸出
None
Out-GridView 不會傳回任何物件。
備註
在 Windows PowerShell 2.0 中，Out-GridView Cmdlet 預設會安裝在用戶端版本的 Windows 上，但是 Windows 伺服器版本的選擇性功能。 在 Windows PowerShell 3.0 中，預設會安裝在所有系統上。 但是，如果關閉或刪除 Windows PowerShell ISE 功能， 則 Out-GridView cmdlet 也會關閉或刪除。
您無法使用遠端命令在另一部電腦上開啟方格檢視視窗。
發送到 Out-GridView 的命令輸出無法格式化，例如使用 Format-Table 或 Format-Wide cmdlet。 若要選取屬性，請使用 Select-Object Cmdlet。
遠端命令的還原串行化輸出可能無法在方格檢視視窗中正確格式化。
Out-GridView 的鍵盤快捷鍵
藉由使用下列鍵盤快捷方式，您可以快速執行許多工作。
使用此鍵：要執行此作：
TAB 將游標從 [篩選] 方塊移至 [新增準則] 功能表至數據表和返回。
向上鍵向上移動一列。 將會移至數據行標頭。
向下箭號 向下移動一列。
向左鍵 在數據行行首列中，向左移動一欄。
向右鍵 在數據行行首列中，向右移動一個數據行。
上下文功能表鍵 在列標題行中，顯示 Select Columns 選項。
ENTER 或 SPACEBAR 在資料行標頭數據列中，排序數據行數據（切換 A-Z、Z-A）。
如何使用 Grid View 視窗功能
以下主題介紹如何使用 Out-GridView 顯示的視窗的功能。
如何隱藏、顯示及重新排序數據行
若要隱藏或顯示資料列：
右鍵按下任何列標題，然後按下 Select Columns。
2. 在「選擇列」對話框中，使用箭頭鍵將「選定列」之間的列移動到「可用列」 框。 只有 Selected Columns （所選取） 框中的列才會顯示在網格檢視視窗中。
若要重新排序資料列：
將數據行拖放到所需的位置。
或-
右鍵按下任何列標題，然後按下 Select Columns。
2. 在「選擇列」對話框中，使用「上移」和「下移」按鈕對列重新排序。 清單頂端的數據行會顯示在方格檢視視窗中清單底部的數據行左邊。
如何排序數據表數據
若要排序數據，請按下數據行標頭。
若要變更排序順序，請再次按下數據行標頭。 每次按一下相同的標頭時，排序順序會在遞增至遞減順序之間切換。 目前的順序是由數據行標頭中的三角形表示。
如何選取數據表數據
若要選取數據列，請按下數據列，或使用向上或向下箭號來流覽至數據列。
若要選取所有數據列（標頭數據列除外），請按 CTRL+A。
若要選取連續的數據列，請在按兩下資料列或使用箭頭鍵時按住 SHIFT 鍵。
若要選取非連續的數據列，請按 CTRL 鍵，然後按下以將數據列新增至選取範圍。
您無法選取資料行，而且無法選取整個資料行行首數據列。
如何複製數據列
- 若要從數據表複製一或多個數據列，請選取數據列，然後按 CTRL+C。
您可以將資料貼到任何文字或電子錶格程式中。 您無法複製資料列或資料列的一部分，也無法複製資料行行首數據列。
如何在資料表中搜尋 （快速篩選）
使用 [篩選] 方塊來搜尋數據表中的數據。 當您在方塊中輸入時，只有包含具類型文字的專案會出現在數據表中。
搜尋文字。 若要搜尋數據表中的文字，請在 [篩選] 方塊中輸入要尋找的文字。
搜尋多個單字。 若要搜尋數據表中的多個單字，請輸入以空格分隔的字組。 Out-GridView 顯示包含所有單詞（邏輯 AND）的行。
搜尋常值片語。 若要搜尋包含空格或特殊字元的片語，請用引號括住片語。 Out-GridView 顯示包含與短語完全匹配的行。
在數據行中搜尋。 若要搜尋一或多個資料列中的文字，請使用下列格式：
<數據行>：<文字> [<欄>：<文字>] ...
例如，若要在 DisplayName 列中查找「Net」，請在 Filter 框中鍵入：
displayname：net
若要查找 DisplayName 和 Name 列中包含「Net」的行，請在 Filter 框中鍵入：
displayname：net name：net
- 關閉搜尋。 要再次顯示整個表格，請按下 Filter 框右上角的紅色 X 按鈕，或從 Filter 框中刪除文字。
使用準則篩選數據表
您可以使用規則或準則來判斷資料表中顯示的專案。 只有在專案符合您建立的所有準則時才會顯示。 可用的準則取決於方格檢視視窗中所顯示之對象的屬性，以及這些屬性的 .NET Framework 類型。
每個準則都有下列格式：
<資料行><運算子><值>
不同屬性的準則會由 AND 連接。 相同屬性的準則是由 OR 連接。 您無法變更邏輯連接器。
準則只會影響顯示。 它不會刪除資料表中的專案。
如何新增準則
1. 要顯示 Add criteria 選單按鈕，請按兩下視窗右上角的 Expand 箭頭。
2. 按兩下 Add Criteria 選單按鈕。
3.按兩下以選取資料行（屬性）。 您可以選取一或多個屬性。
4.當您完成選取屬性時，請按兩下 [新增] 按鈕。
5. 若要取消新增專案，請按兩下 [取消]。
6.若要新增更多準則，請再次按兩下 [新增準則] 按鈕。
如何編輯準則
要更改運算符，請按兩下藍色運算子值，然後按下拉清單中選擇其他運算符。
若要輸入或變更值，請在值方塊中輸入值。 如果您輸入無效的值，就會顯示圓形 X 圖示。 若要移除它，請變更值。
若要建立 OR 語句，請新增具有相同屬性的準則。
如何刪除準則
若要刪除選取的準則，請按兩下每個準則旁邊的紅色 X。
要刪除所有標準，請按兩下 Clear All 按鈕。