Out-GridView
將輸出傳送到單獨視窗中的互動式表格。
語法
Out-GridView [-InputObject <psobject>] [-Title <string>] [<CommonParameters>]
描述
Out-GridView Cmdlet 會將命令的輸出傳送到方格檢視視窗，並在當中的互動式表格中顯示輸出。此功能需要 Microsoft .NET Framework 3.5 Service Pack 1。
您可以使用下列的表格功能檢視資料：
-- 隱藏、顯示及重新排序欄：若要隱藏、顯示或重新排序欄，請以滑鼠右鍵按一下欄標頭，然後按一下 [選取欄位]。
-- 排序：若要排序資料，請按一下欄標頭。再按一下即可從遞增順序切換到遞減順序。
-- 快速篩選：使用視窗頂端的 [篩選] 方塊來搜尋表格中的文字。您可以搜尋特定欄中的文字、搜尋常值和搜尋多個字。
-- 準則篩選：使用 [新增準則] 下拉式功能表建立規則，以篩選資料。這對非常大量的資料集 (如事件記錄檔) 非常有用。
-- 複製與貼上：若要從 Out-GridView 複製資料列，請按 CTRL+C (複製)。您可以將資料貼入任何文字或試算表程式。
如需使用這些功能的指示，請輸入 "Get-Help out-gridview -full"，並查看注意事項一節中的＜如何使用方格檢視視窗功能＞。
參數
-InputObject <psobject>
接受 Out-GridView 的輸入。
當您使用 InputObject 參數將物件的集合 (不只一個) 傳送給 Out-GridView 時，Out-GridView 會將此集合視為一個集合物件，並顯示一個代表此集合的資料列。若要顯示集合中的每一個物件，請使用管線運算子 (|) 將物件傳送給 Out-GridView。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
true (ByValue) |
接受萬用字元? |
false |
-Title <string>
指定出現在 Out-GridView 視窗標題列中的文字。
根據預設，標題列會顯示可呼叫 Out-GridView 的命令。
必要? |
false |
位置? |
named |
預設值 |
目前的命令 |
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.Management.Automation.PSObject 您可傳送任何物件給 Out-GridView。 |
輸出 |
無 Out-GridView 不會傳回任何物件。 |
附註
OUT-GRIDVIEW 的注意事項
----------------------
您可以從 Microsoft 下載中心下載 Microsoft .NET Framework 3.5 Service Pack 1。
因為此 Cmdlet 需要使用者介面，它無法在 Windows Server 的 Server Core 安裝上運作。
您不能使用遠端命令來開啟遠端電腦上的方格檢視視窗。
您所傳送的命令輸出無法透過像是 Format-Table 或 Format-Wide 這類的 Cmdlet 預先格式化。若要選取屬性，請使用 Select-Object Cmdlet。
遠端命令中還原序列化的輸出可能無法在方格檢視視窗中正確格式化。
OUT-GRIDVIEW 的鍵盤快速鍵
-----------------------------------
使用下列鍵盤快速鍵即可快速執行許多工作。
按鍵： 執行動作：
------------- ----------------------------------------------------------------
TAB 將游標從 [篩選] 方塊移至 [新增準則] 功能表，再移至表格，然後往回移。
向上鍵 上移一列。將移至欄標頭。
向下鍵 下移一列。
向左鍵 在欄標頭列中左移一欄。
向右鍵 在欄標頭列中右移一欄。
內容功能表鍵 在欄標頭列中顯示 [選取欄位] 選項。
ENTER 或空格鍵 在欄標頭列中排序欄資料 (在遞增順序和遞減順序之間切換)。
如何使用方格檢視視窗功能
----------------------------------------
下列主題說明如何使用 Out-GridView 所顯示之視窗的功能。
如何隱藏、顯示及重新排序欄
--------------------------------------
若要隱藏或顯示欄：
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 型別所決定。
每一個準則的格式如下：
<欄> <運算子> <值>
不同屬性的準則由 AND 連接。相同屬性的準則是以 OR 連接。您無法變更邏輯連接子。
此準則只會影響顯示。並不會從表格中刪除項目。
如何新增準則
---------------------------
1. 若要顯示 [新增準則] 功能表按鈕，請在視窗的右上角按一下 [展開] 箭頭。
2. 按一下 [新增準則] 功能表按鈕。
3. 按一下以選取欄位 (屬性)。您可以選取一個或多個屬性。
4. 當您屬性選取完畢之後，請按一下 [新增] 按鈕。
5. 若要取消新增的部分，請按一下 [取消]。
6. 若要新增多個準則，請再按一下 [新增準則]。
如何編輯準則
--------------------
-- 若要變更運算子，請按一下藍色運算子值，然後從下拉式清單中
選取其他運算子。
-- 若要輸入或變更值，請在值方塊中輸入值。如果您輸入無效的值，將會出現圓形的 X 圖示。要移除它就必須變更值。
-- 若要建立 OR 陳述式，請新增具有相同屬性的準則。
如何刪除準則
-------------------------
-- 若要刪除選取的準則，請按一下每一個準則旁邊的紅色 X。
-- 若要刪除所有準則，請按一下 [全部清除] 按鈕。
範例 1
C:\PS>get-process | out-gridview
描述
-----------
這個命令會取得本機電腦上所執行的處理序，然後將這些處理序傳送到方格檢視視窗。
範例 2
C:\PS>$p = get-process
C:\PS> $p | out-gridview
描述
-----------
這個命令也會取得本機電腦上所執行的處理序，然後將這些處理序傳送到方格檢視視窗。
第一個命令會使用 Get-Process 命令取得本機電腦上的處理序，然後將處理序物件儲存到 $p 變數。
第二個命令會使用管線運算子將 $p 變數傳送給 Out-GridView。
範例 3
C:\PS>get-process | select-object -property name, workingset, peakworkingset | sort-object -property workingset -desc | out-gridview
描述
-----------
這個命令會在方格檢視視窗中顯示格式化的表格。
它會使用 Get-Process Cmdlet 取得電腦上的處理序。
然後，它會使用管線運算子 (|) 將處理序物件傳送給 Select-Object Cmdlet。這個命令會使用 Select-Object 的 Property 參數選取要在表格中顯示的 Name、WorkingSet 和 PeakWorkingSet 屬性。
另一個管線運算子會將篩選過的物件傳送給 Sort-Object Cmdlet，讓後者依據 WorkingSet 屬性的值以遞減順序進行排序。
這個命令的最後一個部分是使用管線運算子 (|) 將格式化的表格傳送給 Out-GridView。
現在您可以使用方格檢視的功能，對資料進行搜尋、排序和篩選。
範例 4
C:\PS>($a = get-childitem -path $pshome -recurse) | out-gridview
描述
-----------
這個命令會將其輸出儲存到變數，然後將它傳送給 Out-GridView。
該命令會使用 Get-ChildItem Cmdlet 取得 Windows PowerShell 安裝目錄及其子目錄中的檔案。安裝目錄的路徑儲存在 $pshome automatic 變數中。
該命令會使用指派運算子 (=) 將輸出儲存到 $a 變數，而且使用管線運算子 (|) 將輸出傳送給 Out-GridView。
命令中的括號是確定運算的順序。因此，Get-ChildItem 命令的輸出在傳送給 Out-GridView 之前會先儲存到 $a 變數。
範例 5
C:\PS>get-process -computername Server01| ogv -title "Processes - Server01"
描述
-----------
這個命令會在方格檢視視窗中顯示 Server01 電腦上執行的處理序。
該命令會使用 "ogv" (Out-GridView Cmdlet 的內建別名)，而且它會使用 Title 參數指定視窗標題。
範例 6
C:\PS>invoke-command -ComputerName S1, S2, S3 -scriptblock {get-culture} | out-gridview
描述
-----------
這個範例會示範將從遠端電腦收集之資料傳送到 Out-GridView Cmdlet 的正確格式。
該命令會使用 Invoke-Command Cmdlet，在三部遠端電腦上執行 Get-Culture 命令。它會使用管線運算子，將傳回的資料傳送到 Out-GridView Cmdlet。
請注意，包含遠端執行之命令的指令碼區塊不包括 Out-GridView 命令。如果包括，當該命令嘗試在每一部遠端電腦上開啟方格檢視視窗時，命令就會失敗。