Out-GridView
將輸出傳送到另一個視窗中的互動式表格。
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
Out-GridView Cmdlet 會將來自命令的輸出傳送輸到以互動式表格顯示輸出的資料格檢視視窗中。
因為此 Cmdlet 需要使用者介面,它無法在 Windows Server 的 Server Core 安裝上使用。
您可以使用下列表格功能來檢查您的資料:
- 隱藏、顯示及重新排序數據行:若要隱藏、顯示或重新排序數據行,請以滑鼠右鍵按兩下資料行標頭,然後按兩下 [選取數據行]。
- 排序。 若要排序資料,請按一下欄標題。 再按一次即可從遞增順序切換成遞減順序。
- 快速篩選。 使用視窗頂端的 [篩選] 方塊來搜尋表格中的文字。 您可以搜尋特定欄位中的文字、搜尋常值,以及搜尋多個文字。
- 條件篩選。 使用 [新增準則] 下拉功能表來建立規則來篩選數據。 這對非常大型的資料集 (例如事件記錄檔) 來說非常有用。
- 複製及貼上。 若要從 Out-GridView 複製數據列,請按 CTRL+C (複製) 。 您可以將資料貼到任何文字或試算表程式中。
如需使用這些功能的指示,請在附注一節中輸入 Get-Help Out-GridView -Full
及瞭解如何使用方格檢視視窗功能。
範例
範例 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 的 Property 參數來選取要在表格中顯示的 Name、WorkingSet 及 PeakWorkingSet 屬性。
另一個管線運算符會將篩選的物件傳送至 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 命令的輸出會先儲存在$A變數中,再傳送至 Out-GridView。
範例 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-GridView 的 PassThru 參數,這可讓您將多個項目沿著管線向下傳送。 PassThru 參數等同於使用 OutputMode 參數的 Multiple 值。
範例 8:Create 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。
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OutputMode
指定互動式視窗將管線向下傳送為輸入給其他命令的專案。 根據預設,此 Cmdlet 不會產生任何輸出。 若要從互動式視窗將項目沿著管線向下傳送,請按一下項目來進行選取,然後按一下 [確定]。
這個參數的值會決定您可以沿著管線向下傳送的項目數。
- 無。 沒有項目。 這是預設值。
- 單一。 零個項目或一個項目。 如果下一個命令只能接受一個輸入物件,請使用這個值。
- 多個。 零個、一個或許多個項目。 如果下一個命令可以接受多個輸入物件,請使用這個值。 這個值相當於 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 鍵並按一下滑鼠左鍵來進行選取。
此參數是在 Windows PowerShell 3.0 引進。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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。 在捷徑中使用 Out-GridView 而未搭配 Wait 參數時,Out-GridView 視窗只會在 Windows PowerShell 關閉之前短暫顯示。
此參數是在 Windows PowerShell 3.0 引進。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
您可以將任何物件傳送至此 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 將游標從 [篩選] 方塊移至數據表和返回的 [新增準則] 功能表。
向上鍵向上移動一列。 將會移到欄標題。
向下鍵 向下移動一列。
向左鍵 在數據行行首列中,向左移動一個數據行。
向右鍵 在數據行行首列中,向右移動一個數據行。
操作選單鍵 在數據行標頭數據列中,顯示 [選取數據行] 選項。
ENTER 鍵或空格鍵 在欄標題列中,排序欄位資料 (切換 A 到 Z、Z 到 A)。
如何使用方格檢視視窗功能
下列主題說明如何使用 Out-GridView 所顯示的視窗功能。
如何隱藏、顯示及重新排列欄位
隱藏或顯示欄位:
以滑鼠右鍵按下任何數據行標頭,然後按兩下 [選取數據行]。
2.在 [選取數據行] 對話框中,使用箭頭鍵,將 [選取的數據行] 之間的數據行移至 [可用的數據行] 方塊。 只有 [選取的數據行] 方塊中的數據行會出現在方格檢視視窗中。
重新排列欄位:
將欄位拖放到想要的位置。
或-
以滑鼠右鍵按下任何數據行標頭,然後按兩下 [選取數據行]。
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。
若要刪除所有準則,請按兩下 [全部清除] 按鈕。